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3.1 


Convenience Routines 


This chapter contains XUI Toolkit convenience routines and message 


routines. 


Table 3-1 lists the supported convenience routines. 


Table 3-1 Convenience Routines 


Routine Name 


CHILDREN 

GET DISPLAY 

GET SCREEN 

GET WINDOW 
NUMBER CHILDREN 


RESOLVE PART OFFSETS 


VMS CLEAR STRING 

VMS FREE ARGNAMES 
VMS GET DESC VALUE 
VMS SET ARG 

VMS SET CALLBACK ARG 
VMS SET DESC ARG 


Description 


Returns a list of the widget’s children. 
Returns the widget display. 
Returns the widget screen. 
Returns the widget window. 


Returns the number of children that the widget 
has. 


Allows writing of upward-compatible 
applications and widgets. 


Frees a string in an argument list. 

Frees memory allocated for argument names. 
Retrieves a descriptor value. 

Places an argument in the argument list. 
Places a callback in the argument list. 

Places a descriptor in the argument list. 


Table 3—2 lists the supported message routines. 


Table 3-2 Message Routines 


Routine Name 


DISPLAY CS MESSAGE 
DISPLAY VMS MESSAGE 


Convenience Routines 


Description 


Displays a compound string message. 


Accepts and displays a VMS message. 





Convenience routines provide an easy method for obtaining commonly 
required information. Some routines do not have MIT C bindings. 


The following pages describe the XUI Toolkit convenience routines. 
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Convenience Routines 
CHILDREN 


CHILDREN 


Returns a list of the widget’s children. 





VAX FORMAT __ widget_list=DWT$CHILDREN (widget) 


argument 

information Argument Usage Data Type Access Mechanism 
widget_list array uns longword read reference 
widget widget uns longword read reference 





MITC FORMAT  widget_list=DwtChildren (widget) 





argument 

information widget _list DwtChildren (widget) 
CompositeWidget widget; 

RETURNS widget_list 


A list of the widget’s children. 





ARGUMENTS __ widget 


A pointer to the widget data structure. 





DESCRIPTION CHILDREN returns a list of the widget’s children. Children must request 
geometry management changes from their parent. A parent widget can 
resize its children. 


Convenience Routines 
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GET DISPLAY 


Returns the widget display. 





VAX FORMAT display =DWT$GET_ DISPLAY (widget) 


argument 


Information Argument Usage — Data Type Access. = Mechanism 


display uns longword uns longword write value 
widget widget uns longword read reference 





MITC FORMAT display=DwtGetDisplay (widget) 





argument 

information display DwtGetDisplay (widget) 
Widget widget; 

RETURNS display 


The widget display. 





ARGUMENTS _ widget 


A pointer to the widget data structure. 





DESCRIPTION "= GET DISPLAY returns information about the physical device on which the 
widget is displayed. A display is the identifier of the connection between 
the client and the server. 
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GET SCREEN 


GET SCREEN 


Returns the widget screen. 





VAX FORMAT ~ screen=DWT$GET_SCREEN (widget) 


argument 

information Argument Usage Data Type Access Mechanism 
screen uns longword uns longword write value 
widget widget uns longword read reference 





MIT C FORMAT screen=DwtGetScreen (widget) 





argument 

information Screen *DwtGetScreen (widget) 
Widget widget; 

RETURNS screen 


The widget screen. 





ARGUMENTS ~~ widget 


A pointer to the widget data structure. 





DESCRIPTION GET SCREEN returns the widget screen. The screen is the physical 
hardware on which the widget is being displayed. 


Convenience Routines 





GET WINDOW 
Returns the widget window. 
VAX FORMAT window=DWT$GET_WINDOW (widget) 
argument 
information Argument Usage Data Type Access Mechanism 
window uns longword uns longword write value 
widget widget uns longword read reference 





MITC FORMAT window =DwtGetWindow (widget) 





ar gument 

information window DwtGetWindow (widget) 
Widget widget; 

RETURNS window 


The widget window. 





ARGUMENTS __ widget 


A pointer to the widget data structure. 





DESCRIPTION GET WINDOW returns the widget window. The window is a rectangular 
portion of the screen that has event handling and dispatching capabilities. 


Convenience Routines 
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NUMBER CHILDREN 


Returns the number of children that the widget has. 





VAX FORMAT cardinal = DWT$NUMBER_CHILDREN (widget) 


argument 


information Argument Usage —iData Type ~=—-«sAccess.- ~=—S*=é<i«‘Mechratniism 


cardinal uns longword uns longword __ write value 
widget widget uns longword read reference 





MIT C FORMAT cardinal =DwtNumberChildren (widget) 





argument 

information Cardinal DwtNumberChildren (widget) 
CompositeWidget widget; 

RETURNS cardinal 


The number of children; a positive integer. 





ARGUMENTS _ widget 


A pointer to the widget data structure. 





DESCRIPTION NUMBER CHILDREN returns the number of children that the widget 
has. 


i 
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Convenience Routines 
RESOLVE PART OFFSETS 


RESOLVE PART OFFSETS 


Allows writing of upward-compatible applications and widgets. 





VAX FORMAT void = DWT$RESOLVE_PART_OFFSETS 
(widget_class, offset) 


argument 

information Argument Usage Data Type Access Mechanism 
widget_class widget class uns longword read reference 
offset uns longword uns longword write reference 





MIT C FORMAT void = DwtResolvePartOffsets 
(widget_class, offset) 


argument 

information void DwtResolvePartOffsets (widget_class, offset) 
WidgetClass widget_class; 
DwtOffsetPtr *offset; 





ARGUMENTS '__ widget_class 
The widget class for which to resolve the part offset. 


offset 


The variable that contains a pointer to the class offset array. 





DESCRIPTION RESOLVE PART OFFSETS allows you to write upward-compatible 

. applications and widgets. The widget instance records defined by the 
X Toolkit are not inherently upward compatible. That is, applications 
and widgets built outside of the X Toolkit cannot use hard-coded offsets 
in the widget instance records, and they cannot expect to run without 
recompilation as subsequent releases of the XUI toolkit are made. There 
is, however, a method for writing upward-compatible applications and 
widgets. 


Applications and widgets must never read or write another widget’s fields 
directly. The only exception is that the parent of a widget can write the 
widget’s geometry fields as its geometry manager. A widget not guaranteed 
to be recompiled with the intrinsic routines must use an offset record to 
access the fields within its instance record. 


- Convenience Routines 
RESOLVE PART OFFSETS 
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The use of offset records requires one extra global variable per widget 
class. The variable consists of a pointer to an array of offsets in the widget 
record for each part of the widget structure. These offsets are allocated by 
RESOLVE PART OFFSETS and are used by the widget to access all of the 
widget’s variables. 


A widget needs to perform the following actions: 


Instead of creating a resource list, the widget creates an offset resource 
list (C macros DwtPartResource and DwtPartOffset are provided as 
an aid). The data structure for this looks just like a resource list, but 
instead of having one integer for its offset, it has two 16-bit unsigned 
quantities. These quantities are put into the class record as if it were 
a normal resource list. Instead of using XtOffset for the offset, it uses 
DwtPartOffset. 


Instead of putting the widget size in the class record, the widget puts 
the widget part size in the same field. 


Instead of putting the symbol XtVersion in the class record, the widget 
puts the symbol XtVersionDontCheck in the class record. 


The widget defines a variable to point to the offset record. This can be 
part of the widget’s class record or a separate global variable. 


In class initialization, the widget calls the RESOLVE PART OFFSETS, 
and passes it the address of the offset variable and the class record. 
This operation does several things: 


— Adds the superclass (which, by definition, has already been 
initialized) size field to the part size field. 


— Allocates an array based upon the number of superclasses. 


— Fills in the offsets of all the widget parts with the appropriate 
values, determined by examining the size fields of all superclass 
records. 


— Uses the part offset array to modify the offset entries in the 
resource list to be real offsets, in place. 


Instead of accessing fields directly, the widget must always go through 
the offset array. The entries contain the offsets within the widget 
instance record of the various widget parts. The widget must add the 
offset of a particular field within a part to the offset of the part to get 
the address of the field. 


You can define macros for each field to make this easier. Assume an 
integer field member xyz: 


#define BarXyz (w) 
(*(int *) (((char *) w) + 
offset [BarIndex] + 
XtOffset (BarPart,xyz))) 


A C macro DwtField has been provided. Because the DwtPartOffset 
and DwtField macros concatenate arguments, make sure there is no 
space before or after the part argument; for example: 


DwtField(w, offset,Label, text, char *) 


Convenience Routines 
RESOLVE PART OFFSETS 


Note that there are no spaces placed before or after Label. 


Because of the space before the part argument, the following example 
does not work: 


DwtField(w, offset, Label, text, char *) 
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Convenience Routines 
VMS CLEAR STRING 


VMS CLEAR STRING 


Frees a string in an argument list. 








VAX FORMAT  void=DWT$VMS_CLEAR_STRING 
(arglist, argnumber) 
argument 
information Argument Usage Data Type Access Mechanism 
arglist uns longword uns longword read reference 
argnumber uns longword uns longword read reference 
ARGUMENTS ~ arglist 
The argument list. 
argnumber 


The index to the argument list where the argument is to be placed. 





DESCRIPTION VMS CLEAR STRING frees a string in an argument list. 


Convenience Routines 
VMS FREE ARGNAMES 


VMS FREE ARGNAMES 


Frees memory allocated for argument names. 








VAX FORMAT  void=DWT$VMS_FREE_ARGNAMES 
(arglist, argcount) 
argument 
information Argument Usage Data Type Access Mechanism 
arglist uns longword uns longword read reference 
argcout uns longword uns longword read reference 
ARGUMENTS -— arglist 
The argument list. 
argcount 


The index to the argument list where the argument is to be placed. 





DESCRIPTION VMS FREE ARGNAMES frees memory allocated for argument names in 


the argument list. This memory is allocated by VMS SET ARG, converting 
the name descriptors into C null-terminated strings. 
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Convenience Routines 
VMS GET DESC VALUE 


VMS GET DESC VALUE 


Gets a descriptor value. 





VAX FORMAT void =DWT$VMS_GET_DESC_VALUE 


(value, buffer, length) 


argument 

information Argument Usage 
value uns longword 
buffer uns longword 
length uns longword 


Data Type 


uns longword 
uns longword 
uns longword 


Access 


read 
read 
read 


Mechanism 


reference 
reference 
reference 





ARGUMENTS value 


The address of the null-terminated string. 


buffer 


The descriptor into which the argument is written. 


length 


The length of the descriptor. 





DESCRIPTION VMS GET DESC VALUE retrieves a descriptor from an argument list. 


3-12 


Convenience Routines 











VMS SET ARG 
Places an argument in the argument list. 
VAX FORMAT void=DWT$VMS_SET_ARG 
(arg, arglist, argcount, argname) 
argument 
information Argument Usage Data Type Access Mechanism 
arg longword longword read reference 
arglist uns longword —_uns longword read reference 
argcount uns longword uns longword read reference 
argname char string char string read descriptor 
ARGUMENTS 4g 
The argument to be added to the argument list. 
arglist 
The argument list. 
argcount 
The index to the argument list where the argument is to be placed. 
argname 
The name of the resource. 
DESCRIPTION VMS SET ARG places any argument except the callback pointer or 


descriptor in the argument list. Note that the argument name descriptor 
is converted into a C null-terminated string, which involves memory 
allocation. Release this memory after using the argument list by calling 
VMS FREE ARGNAMES. 
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Convenience Routines 
VMS SET CALLBACK ARG 


VMS SET CALLBACK ARG 


Places a callback in the argument list. 





VAX FORMAT 


void = DWT$VMS_SET_CALLBACK_ARG 
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(callback_arg, arglist, argnumber, argname) 
- argument 

information Argument Usage Data Type Access Mechanism 
callback_arg uns longword uns longword _ write reference 
arglist uns longword uns longword read reference 
argnumber uns longword uns longword read reference 
argname char_string char_string read descriptor 

ARGUMENTS ~ Callback_arg 
The callback list. 
arglist 
The argument list. 
argnumber 
The index to the argument list where the argument is to be placed. 
argname 
The name of the argument. 

DESCRIPTION VMS SET CALLBACK ARG places a callback in the argument list. Note 


that the argument name descriptor is converted into a C null-terminated 
string, which involves memory allocation. Release this memory after using 
the argument list by calling VMS FREE ARGNAMES. 


Convenience Routines 
VMS SET DESC ARG 


VMS SET DESC ARG 


Places a descriptor in the argument list. 





VAX FORMAT = void = DWT$VMS_SET_DESC_ARG 
(arg, arglist, argcount, argname) 


argument 

information Argument Usage Data Type Access Mechanism 
arg _ longword longword read reference 
arglist uns longword uns longword read reference 
argcount uns longword uns longword read reference 
argname char_string char_string read descriptor 
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The descriptor to be added to the argument list. 


arglist 
The argument list. 


argcount 
The index to the argument list where the argument is to be placed. 


argname 
The name of the argument. 





DESCRIPTION VMS SET DESC ARG places a descriptor in the argument list. Note that 
the argument name descriptor is converted into a C null-terminated string, 
which involves memory allocation. Release this memory after using the 
argument list by calling VMS FREE ARGNAMES. 
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3.2 


Convenience Routines 
3.2 Message Routines 





Message Routines 
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The message routines allow messages to be formatted using the $FAO 
utility, and to be displayed in a message box. Messages such as those from 
the operating system appear in a message box. The messages themselves 
are either stored in a VMS message file or are supplied by the application 
as compound strings. 


The message box can be either modal or modeless. The title bar identifies 
the message box with the title Message and contains a push-to-back icon. 
The message box contains a message box icon in the upper-left corner, an 
Acknowledged push button on the bottom, and the text of the message in 
the middle. The lines of the message are separated by <CR><LF> pairs or 
“1? in $FAO. Multiple messages are separated by blank lines. 


The user clicks on the Acknowledged push button to erase the message. 
To receive online help on the message, the user presses the Help key while 
the message box has input focus. 


In addition to the standard $FAO system service flags, the compound 
string message routines (DWT$DISPLAY_CS_MESSAGE and 
DwtDisplayCsMessage) accept the flag “!CS”. When used, this flag accepts 
a compound string itself. 


ULTRIX applications can make use of the $FAO string substitution utility. 
Messages defined in the XUI Resource Manager (DRM) database can be 
supplied to the appropriate message routine to be formatted and displayed. 


The following pages describe the XUI Toolkit message routines. 


Message Routines 
DISPLAY CS MESSAGE 


DISPLAY CS MESSAGE 


Displays a compound string message 





VAX FORMAT __ widget = DWT$DISPLAY_CS MESSAGE 
(parent_widget, name, default_position, x, y, style, 
message_vector, widget, convert_proc, ok_callback, 
help_callback) 


argument 

information Argument Usage Data Type Access Mechanism 
widget widget uns longword write value 
parent_widget widget uns longword read reference 
name char_string char string read descriptor 
default_position Boolean uns longword read reference 
X position uns longword read reference 
y position uns longword read reference 
style longword uns longword read reference 
message_vector cnitrlblk longword read reference 
widget widget uns longword modify reference 
convert_proc void_proc proc entry mask read reference 
ok_callback callback uns longword read reference 
help_callback callback uns longword read reference 





MIT C FORMAT widget = DwtDisplayCsMessage 
(parent_widget, name, default_position, x, y, style, 
message_vector, widget, convert_proc, ok_callback, 
help_callback) 
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Message Routines 
DISPLAY CS MESSAGE 








argument 
information Widget DwtDisplayCsMessage (parent widget, name, 
default position, x, y, 
style, message vector, 
widget, convert_proc, 
ok_callback, help callback) 
Widget parent_widget; 
char *name; 
Boolean default_position; 
Position x; 
Position Vi 
unsigned char style; 
int *xmessage vector; 
Widget *widget ; 
int (*convert_proc) (); 
DwtCallbackPtr ok_callback; 
DwtCallbackPtr help callback; 
RETURNS widget 
The identifier of the created widget. 
ARGUMENTS _ parent_widget 


The identifier of the parent widget for the created widget. 


name 


The name of the created widget. 


default_position 
If true, x and y values are ignored, which forces the default. The default 
position is centered in the parent window. 


xX 


The placement, in pixels, of the left side of the widget window relative to 
the inner upper left corner of the parent window. 


The placement, in pixels, of the upper side of the widget window relative 
to the inner upper left corner of the parent window. 


style 
The style of the dialog box widget. The predefined values for this attribute 
are as follows: 


VAX Cc Description 


DWT$C_MODAL 
DWT$C_MODELESS 


DwtModal 
DwitModeless 


Modal type box (default) 
Modeless type box 


message_vector 
The message argument vector specifying the compound strings and 
associated information. 


Message Routines 
DISPLAY CS MESSAGE 


The first longword contains the number of longwords in the message blocks 
to follow. The first longword in each message block contains a pointer to 
the compound string. The next word consists of the $FAO parameter 
count. The final remaining longwords in the message block are the $FAO 
parameters. 


In addition to the standard $FAO system service flags, the compound 
string message routine will accept the new FAO directive “!CS.” When 
used, this directive will insert a compound string itself. 


widget 

The widget identifier of an already-existing message box widget. If this 
argument is not zero, a new message box is not created. The intrinsic 
routine SET VALUES is called on this widget to change the text of the 
message to match the new message. This variable can be modified, so 
after the routine is called, the message box widget identifier is filled in by 
the routine. 


convert_pr oc 
A pointer to a routine that is executed after the message is formatted but 
before it is displayed. 


A pointer to the formatted string is passed to the routine as a parameter. 
In the VAX binding, the parameter is a descriptor. In the C binding, the 
parameter is a null-terminated character string. 


ok_callback 


A callback descriptor data structure. The callback is executed when the 
user clicks on the Acknowledged button. The reason is CRYes. 


help_callback 
A callback descriptor data structure. The callback is executed when the 
user requests help. The reason returned is CRHelp. 





DESCRIPTION 


DISPLAY CS MESSAGE accepts an array of compound strings, formats 
them, and creates a message box. 


If the routine returns a zero, the message is not appended to the messages 
to be displayed. 
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Message Routines 
DISPLAY VMS MESSAGE 


DISPLAY VMS MESSAGE 


Accepts and displays a VMS message. 





VAX FORMAT 


argument 


information 


widget = DWT$DISPLAY_VMS_MESSAGE 
(parent_widget, name, default_position, x, y, style, 
message_vector, widget, convert_proc, ok_callback, 
help_callback) 


Argument Usage Data Type Access Mechanism 
widget widget uns longword write value 
parent_widget widget uns longword read reference 
name char_string char string read descriptor 
default_position Boolean — uns longword read reference 
X position uns longword read reference 
y position uns longword read reference 
style longword uns longword read reference 
message_vector entriblk longword read reference 
widget widget uns longword modify reference 
convert_proc void_proc proc entry mask read reference 
ok_callback callback uns longword read reference 
help_ callback callback uns longword read reference 





MIT C FORMAT widget = DwtDisplayVmsMessage 
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(parent_widget, name, default_position, x, y, style, 
message_vecior, widget, convert_proc, ok_callback, 
help_callback) 


Message Routines 
DISPLAY VMS MESSAGE 








argument 
information Widget DwtDisplayVmsMessage (parent widget, name, 
default_position, x, y, 
style, message _vector, 
widget, convert_proc, 
ok_callback, help callback) 
Widget parent_widget; 
char *name; 
Boolean default_position; 
Position x; 
Position Vi 
unsigned char style; 
int *message_ vector; 
Widget *wldget; 
int (*convert_proc) (); 
DwtCallbackPtr ok_callback; 
DwtCallbackPtr help callback; 
RETURNS widget 
The identifier of the created widget. 
ARGUMENTS _ parent_widget 


The identifier of the parent widget for the created widget. 


name 


The name of the created widget. 


default_position 


If true, x and y are ignored, which forces the default. The default position 
is centered in the parent window. 


X 
The placement, in pixels, of the left side of the widget window relative to 
the inner upper left corner of the parent window. 


The placement, in pixels, of the upper side of the widget window relative 
to the inner upper left corner of the parent window. 


style 
The style of the dialog box widget. The predefined values for this attribute 
are as follows: 


VAX Cc Description 


DWT$C_MODAL 
DWT$C_MODELESS 


DwitModal 
DwtModeless 


Modal type box (default) 
Modeless type box 


message_vector 

The message argument vector specifying the message identifier and 
associated information. This argument is identical to the VMS $PUTMSG 
system service. 


Message Routines 
DISPLAY VMS MESSAGE 


The first longword contains the number of longwords in the message blocks 
to follow. The first longword in each message block contains a pointer to 
the VMS message identifier. Message identifiers are passed by value. 


If the message is supplied by the application, the next word consists of the 
$FAO parameter count. The remaining longwords in the message block 
are the $FAO parameters. 


widget 

The widget identifier of an already-existing message box widget. If this 
argument is not zero, a new message box is not created. The intrinsic 
routine SET VALUES is called on this widget to change the text of the 
message to match the new message. This variable can be modified, so 
after the routine is called, the message box widget identifier is filled in by 
the routine. 


con vert_pr Oc 
A pointer to a routine that is executed after the message is formatted but 
before it is displayed. 


A pointer to the formatted string is passed to the routine as an argument. 
In the VAX binding, the parameter is a descriptor. In the C binding, the 
parameter is a null-terminated character string. 


ok_callback 


A callback descriptor data structure. The callback is executed when the 
user clicks on the Acknowledged button. The reason is CRYes. 


help_callback 
A callback descriptor data structure. The callback is executed when the 
user requests help. The reason returned is CRHelp. 





DESCRIPTION 
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DISPLAY VMS MESSAGE accepts standard VMS message vectors (as 
defined by the $PUTMSG system service), retrieves the messages, formats 
them, and creates a message box in which to display the message. 


If the routine returns a zero, the message is not appended to the messages 
to be displayed. 


4 XUI Resource Manager (DRM) Routines 


The following routines define the application interface to the XUI Resource 
Manager (DRM). The DRM is responsible for creating widgets based on 
definitions contained in the User Interface Definition (UID) files created 
by the User Interface Language (UIL) compiler. The DRM interprets the 
output of the UIL compiler and generates the appropriate argument lists 
for the low-level widget routines. 


The routines in this chapter allow an application to initialize the DRM, 
to provide information required by the DRM to successfully interpret 
information contained in the UID files, and to create widgets using 

the UID file definitions. The DRM also contains routines that allow an 
application to read literal definitions from the UID files. These definitions 
are created by using the EXPORT VALUE definitions in the UIL; the 
resulting literals may be used for any purpose the application requires. 


The representation of widgets in a UID file is not exposed in these 
routines. All management and translation of these representations is done 
internally. The interface for reading literals is low-level, and it exposes 
the definition of both literals themselves and of the DRM mechanisms for 
accessing the UID file resources. 


All definitions required to use the DRM facilities are contained in 
DwtAppl.h. 


For concepts related to DRM routines and information about how to 
use them, see the VMS DECwindows User Interface Language Reference 
Manual. Table 4-1 lists the supported DRM routines. 


Table 4-1 DRM Routines 
Routine Name Description 
CLOSE HIERARCHY Closes a DRM hierarchy. 


DRM FREE RESOURCE CONTEXT _ Frees a resource context and its buffer. 
DRM GET RESOURCE CONTEXT Gets a new resource context and a buffer. 


DRM HGET INDEXED LITERAL Fetches indexed literals from a DRM hierarchy. 

DRM RC BUFFER Returns a pointer to the resource context 
buffer. 

DRM RC SET TYPE Modifies the type in the resource context. 

DRM RC SIZE Returns the size of the value in the resource 
context. 

DRM RC TYPE Returns the type of the value in the resource 


context buffer. 


(continued on next page) 
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XUI Resource Manager (DRM) Routines 





4.1 DRM Routines 
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Table 4—1 (Cont.) DRM Routines 


Routine Name Description 

FETCH INTERFACE MODULE Fetches all the widgets defined in an interface 
module in the DRM hierarchy. 

FETCH SET VALUES Fetches the values to be set from literals 
stored in UID files. 

FETCH WIDGET Fetches any indexed widget. 

FETCH WIDGET OVERRIDE Fetches any indexed widget. Overrides 
FETCH WIDGET arguments. 

INITIALIZE DRM Prepares an application to use the DRM 
facilities. 

OPEN HIERARCHY Opens ail the UID files in the DRM hierarchy. 

REGISTER CLASS Provides the DRM with the information about 
a widget class defined by the application. 

REGISTER DRM NAMES Registers a vector of names of identifiers or 


callback routines for access in DRM. 


The following pages describe the XUI Toolkit XUI Resource Manager 
(DRM) routines. 


DRM Routines 
CLOSE HIERARCHY. 


CLOSE HIERARCHY 


Closes a DRM hierarchy. 





VAX FORMAT status = DWT$CLOSE_HIERARCHY  (hierarchy_id) 


argument 


information Argument | Usage —~DataType += Access. ~=—s Mechanism 


status integer longword write value 
hierarchy_id identifier longword read value 


MIT C FORMAT status = DwtCloseHierarchy  (hierarchy_id) 








argument 
information int DwtCloseHierarchy (hierarchy id) 
DRMHierarchy hierarchy id; 
RETURNS status 
The status return value. Possible status return values for this routine are 
as follows: 
Return Value Name Description 
DRMSuccess The operation succeeded. 
DRMFailure : The operation failed. 





ARGUMENTS __hierarchy_id 
The identifier of an open DRM hierarchy. 





DESCRIPTION CLOSE HIERARCHY closes a DRM hierarchy. A DRM hierarchy is a 
collection of open UID files. 
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DRM FREE RESOURCE CONTEXT 


DRM FREE RESOURCE CONTEXT 


Frees a resource context and its buffer. 





VAX FORMAT _ siatus = DWT$DRM_FREE_RESOURCE_CONTEXT 
(context_id) 


argument 

information Argument Usage Data Type Access Mechanism 
Status integer longword write value 
context_id identifier longword read value 





MIT C FORMAT _siatus = DwtDrmFreeResourceContext 
(context_id) 





argument 
information int DwtDrmFreeResourceContext (context_id) 
DRMResourceContextPtr context_id; 
RETURNS status 
The status return value. Possible status return values for this routine are 
as follows: 
Return Value Name Description 
DRMSuccess The operation succeeded. 
DRMBadContext The resource context is invalid. 





ARGUMENTS _ context_id 


The resource context to be freed. 





DESCRIPTION DRM FREE RESOURCE CONTEXT frees the resource context and its 
associated buffer. 


DRM Routines 
DRM GET RESOURCE CONTEXT 


DRM GET RESOURCE CONTEXT 


Gets a new resource context and a buffer. 





VAX FORMAT _— status=DWT$DRM_G ET RESOURCE CONTEXT 
(alloc_func, free_func, size, context_id_return) 


argument 

information Argument Usage Data Type Access Mechanism 
status integer longword write value 
alloc_func procedure procedure entry mask read value 
free_func void proc _— procedure entry mask read value 
size word word read reference 
context_id_return identifier longword write reference 





MIT C FORMAT _ status = DwtDrmGetResourceContext 
(alloc_func, free_func, size, context_id_return) 





argument 
information int DwtDrmGetResourceContext (alloc func, free func, size, 
context_id_ return) 
char *((*alloc_ func) ()); 
void (*free func) ();7 
DRMSize size; 
DRMResourceContextPtr *context_id_ return; 
RETURNS status 
The status return value. Possible status return values for this routine are 
as follows: 
Return Value Name Description 
DRMSuccess The operation succeeded. 
DRMFailure The operation failed. 





ARGUMENTS __ alloc_func 


A routine that allocates memory for this resource context. A null pointer 
activates the default (the intrinsic routine MALLOC). 
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DRM GET RESOURCE CONTEXT 


free_func 
A routine that frees memory for this resource context. A null pointer 
activates the default (the intrinsic routine FREE). 


size 
The size of the buffer. 


context_id_return 
The new resource context. 





DESCRIPTION DRM GET RESOURCE CONTEXT allocates a new resource context and 
a buffer of the requested size. DRM GET RESOURCE CONTEXT then 


associates the buffer with the resource context. 
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DRM HGET INDEXED LITERAL 


Fetches indexed literals from a DRM hierarchy. 





VAX FORMAT _ siatus=DWT$DRM_HGET_INDEXED LITERAL 
(hierarchy_id, index, context_id) 


argument 

information Argument Usage Data Type Access Mechanism 
status integer longword write value 
hierarchy_id identifier longword read value 
index char string char string read descriptor 
context_id identifier longword read value 





MIT C FORMAT _ status = DwtDrmHGetindexedLiteral 
(hierarchy_id, index, context_id) 





argument 
information int DwtDrmHGetIndexedLiteral (hierarchy_id, index, context_id) 
DRMHierarchy hierarchy id; 
String index; 
DRMResourceContextPtr context_id; 
RETURNS status 
The status return value. Possible status return values for this routine are 
as follows: 
Return Value Name Description 
DRMSuccess The operation succeeded. 
DRMFailure The operation failed. 
DRMNotFound The literal was not found. 


ARGUMENTS __ hierarchy _id 
The identifier of an open DRM hierarchy. 


index 


The case-sensitive name of the desired literal. 


context_id 


The identifier of the resource context into which the literal is read. 
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DESCRIPTION DRM HGET INDEXED LITERAL searches a DRM hierarchy for a literal 
given its index; that is, it gets an exported literal from a DRM search 
hierarchy. DRM GET INDEXED LITERAL returns the literal as the 
contents of the resource context buffer. The group that is fetched is always 
DRMgLiteral. 


Prior to calling HGET INDEXED LITERAL, the DRM routine RC SET 
TYPE should be called using both the same resource context identifier as 
the one used in HGET INDEXED LITERAL, and the constant DRMtNul. 


The literal type filter is taken from the resource context; if unmodified in 
the context as obtained from DRM GET RESOURCE CONTEXT, there is 
no filtering (type=RGMtNul). In general, you do not need to set any of the 
fields in the resource context, except, possibly, type. 





The following buffer contents are for some common literal types obtained 
from a UID file. Note that in some cases that the caller of the routine 
must cause offsets to be memory pointers. 


DwtDrmRCType (context_id) == RGMrTypeChar8: 
DwtDrmRCBuffer (context_id) contains a null-terminated ASCII string 


DwtDrmRCType (context_id) == RGMrTypeCString: 
DwtDrmRCBuffer(context_id) contains a compound string (DwtCompString) 


DwtDrmRCType (context_id) == RGMrTypeChar8Vector: 

DwtDrmRCType (context_id) == RGMrTypeCStringVector: 
DwtDrmRCBuffer (context_id) contains an RGM text vector or stringtable 
(RGMTextVector). The items in the text vector contain offsets into the 
buffer that locate either null-terminated ASCII strings or compound 
strings. These can be relocated to memory pointers by adding the buffer 
address to the offset, that is: 


item [n] .textitem.pointer = item |n] textitem.of fset + bufadr 
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DRM RC BUFFER 


Returns a pointer to the resource context buffer. 





VAX FORMAT __buffer=DWT$DRM_RC_BUFFER (context _id) 


argument 


Information Argument Usage —-Data Type = + Access =—- Mechanism __ 


buffer address longword write value 
context_id identifier longword read value 





MIT C FORMAT _ buffer = DwtDrmRCBuffer (context_id) 





argument 

information buffer DwtDrmRCBuffer (context_id) 
DRMResourceContextPtr context_id; 

RETURNS buffer 


A pointer to the resource context buffer. 





ARGUMENTS _~ context_id 


The resource context. 





DESCRIPTION DRM RC BUFFER returns a pointer to the resource context buffer that 
contains the data for this resource context. 
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DRM RC SET TYPE 


Modifies the type in the resource context. 





VAX FORMAT = void = DWT$DRM_RC_SET_TYPE (context_id, type) 


argument 


information Argument Usage —-~iData Type = Access_-~=—S—s—é<«éMechhazrnicmm 


context_id identifier longword read value 
type word word read reference 





MITC FORMAT void=DwtDrmRCSetType  (context_id, type) 


argument 

information void DwtDrmRCSetType (context_id, type) 
DRMResourceContextPtr context_id; 
DRMType type; 





ARGUMENTS _ context_id 


The resource context. 


type 
The new value for the resource type. 





DESCRIPTION DRMRC SET TYPE modifies the type in the resource context. DRM RC 
SET TYPE is called prior to DRM HGET INDEXED LITERAL. 
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DRM RC SIZE 


Returns the size of the value in the resource context buffer. 





VAX FORMAT ~ size=DWT$DRM_RC_SIZE _ (context_id) 


argument 

information Argument Usage Data Type Access Mechanism 
size integer word write value 
context_id identifier longword read value 





MITC FORMAT size =DwtDrmRCSize (context_id) 





argument 

information DRMsize DwtDrmRCSize (context_id) 
DRMResourceContextPtr context_id; 

RETURNS size 


The size, in bytes, of the value in the resource context buffer. 





ARGUMENTS _ context_id 


The resource context. 





DESCRIPTION DRM BC SIZE returns the size of value in the resource context buffer. 


DRM Routines 
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DRM RC TYPE 


Returns the type of the value in the resource context buffer. 





VAX FORMAT _ type =DWT$DRM_RC_TYPE (context id) 


argument 

information Argument Usage Data Type Access Mechanism 
type integer word write value 
context_id identifier longword read value 





MITC FORMAT type=DwtDrmRCType  (context_id) 





argument 

information DRMtype DwtDrmRCType (context_id) 
DRMResourceContextPtr context _id; 

RETURNS type 


The type of the value in the resource context buffer. 





ARGUMENTS __ context_id 


The resource context. 





DESCRIPTION DRM RC TYPE returns the type of the value in the resource context 
buffer. 
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FETCH INTERFACE MODULE 


Fetches all the widgets defined in an interface module in the DRM hierarchy. 





VAX FORMAT _ status = DWT$FETCH_INTERFACE_MODULE 
(hierarchy_id, module_name, parent_widget, 
widget_return) 


argument 

information Argument Usage Data Type Access Mechanism 
status integer longword write : value 
hierarchy_id identifier longword read value 
module_name _ char string char string read descriptor 
parent_widget _ identifier longword read reference 
widget_return identifier longword write reference 





MIT C FORMAT _sstaius = DwtFetchinterfaceModule 
(hierarchy_id, module_name, parent_widget, 
widget_return) 





argument 
information int DwtFetchInterfaceModule (hierarchy id, module_name, 
parent widget, widget_return) 
DRMHierarchy hierarchy id; 
char *xmodule_ name; 
Widget parent widget; 
Widget *widget_return; 
RETURNS status 
The status return value. Possible status return values for this routine are 
as follows: 
Return Value Name Description 
DRMSuccess The operation succeeded. 
DRMFailure . The operation failed. 
DRMNotFound The interface module or topmost widget was 
not found. 
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ARGUMENTS __ hierarchy _id 


The identifier of the DRM hierarchy that contains the interface definition. 


module_name 
The name of interface module defining the top level of the interface; by 
convention, this is usually the generic name of the application. 


parent_widget 
The parent widget for the topmost widgets being fetched from the module; 
usually, the top-level widget. 


widget_return 
Returns the widget identifier of the main window widget for the 
application. 





DESCRIPTION FETCH INTERFACE MODULE fetches all the widgets defined in an 
interface module in the DRM hierarchy. Typically, one or more modules 
define an application interface; each module must be fetched in order to 
initialize all the widgets the application requires. Applications do not need 
to define all their widgets in a single module. 


If the module defines a main window widget, FETCH INTERFACE 
MODULE returns its identifier. If no main window widget is contained in 
the module, a null value is returned. The identifiers of widgets other than 
the main window widget can be obtained by using creation callbacks. 
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FETCH SET VALUES 


Fetches the values to be set from literals stored in UID files. 





VAX FORMAT _ status = DWT$FETCH_SET_VALUES 
(hierachy_id, widget, args, num_args) 


argument 

information Argument Usage Data Type Access Mechanism 
status integer longword write value 
hierarchy_id identifier longword read value 
widget uns longword —_ uns longword read reference 
args arglist uns longword read reference 
num_args word longword read reference 





MIT C FORMAT _siaius = DwtFetchSetValues 
(hierarchy_id, widget, args, num_args) 





argument : 
information int DwtFetchSetValues (hierarchy id, widget, args, num_args) 
DRMHierarchy hierarchy id; 
Widget widget; 
ArgList args; 
Cardinal num_args; 
RETURNS status 
The status return value. Possible status return values for this routine are 
as follows: 
Return Value Name Description 
DRMSuccess The operation succeeded. 
DRMFailure The operation failed. 





ARGUMENTS __hierarchy_id 


The identifier of the DRM hierarchy that is searched for literal definitions. 


widget 
The widget that is modified. 
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FETCH SET VALUES 


args 

An argument list that specifies the widget arguments to be modified. The 

name part of each argument must be the DwtN... string that identifies the 
argument tag. The value part must be a string that gives the index of the 
literal. All literals must be literals accessed by index. 


num_args 


The number of entries in args. 





DESCRIPTION 


4-16 


FETCH SET VALUES is a cover routine for the intrinsic routine SET 
VALUES that fetches the values to be set from literals stored in UID files. 


FETCH SET VALUES sets the values on a widget and evaluates the 
values as public literal resource references resolvable from a DRM 
hierarchy. Each literal is fetched from the hierarchy, and its value is 
modified and converted as required. This value is then placed in the 
argument list and is used as the actual value for a call to the intrinsic 
routines SET VALUES. 


FETCH SET VALUES allows a widget to be modified after creation using 
UID file values, exactly as is done in FETCH WIDGET. As in FETCH 
WIDGET, each argument whose value can be evaluated from the UID 
hierarchy is set in the widget. Values that are not found or values in 
which conversion errors occur are not modified. 


Each entry in the argument list identifies an argument to be modified in 
the widget. The name part of each argument must be the DwtN... string 
that identifies the argument tag. The value part must be a string that 
gives the index of the literal. Consequently, the following code would 
modify the label resource of the widget to have the value of the literal 
accessed by index OK_button_label in the hierarchy: 


args[n].name = "label" (DwtNlabel) 
args[n].value = "OK_button_label" 


DRM Routines 
FETCH WIDGET 


FETCH WIDGET 


Fetches any indexed widget. 





VAX FORMAT _ status = DWT$FETCH_WIDGET 
(hierarchy _id, index, parent_widget, widget_return, 
class_return) 


argument 

information Argument Usage Data Type Access Mechanism 
status integer longword write value 
hierarchy_id identifier longword read value 
index char string char string read descriptor 
parent_widget — uns longword uns longword read reference 
widget_return identifier longword write reference 
class_return word word write reference 





MITC FORMAT status = DwtFetchWidget 
(hierarchy_id, index, parent_widget, widget_return, 
class_return) 





argument 
information int DwtFetchWidget (hierarchy id, index, parent_widget, 
widget _return, class_return) 
DRMHierarchy hierarchy id; 
String index; 
Widget parent widget; 
Widget *widget_return; 
DRMType *class return; 
RETURNS status 
The status return value. Possible status return values for this routine are 
as follows: 
Return Value Name Description 
DRMSuccess The operation succeeded. 
DRMNotFound The widget was not found in hierarchy. 
DRMFailure The operation failed. 
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ARGUMENTS __ hierarchy _id 
The identifier of the DRM hierarchy that contains the interface definition. 


index 
The name of the widget to fetch. 


parent_widget 
The identifier of the parent widget. 


widget_return 
The identifier of the created widget. 


class_return 

The code identifying the widget class. This argument is used to distinguish 
the main window from the other XUI Toolkit widgets. This argument 
must be supplied, but its value is undefined and should not be used by the 
application. 





DESCRIPTION FETCH WIDGET fetches any indexed widget. The index that identifies 
the widget must be known to the application. In fetch operations, the 
fetched widget’s subtree is also fetched. This widget must not appear as 
the child of a widget within its own subtree (in other words, there can be 
no cycles in the subtree graph). FETCH WIDGET does not execute the 
intrinsic routine MANAGE CHILD for the newly created widget. 


All widgets that FETCH WIDGET fetches must meet the following 
requirements: 


¢ Must not be referenced as the child of any widget in the database 
¢ Must be indexed 


FETCH WIDGET fetches widgets where FETCH INTERFACE MODULE 
is not used. Any named widget in the DRM hierarchy can be fetched 
using this routine. FETCH WIDGET can be called at any time to fetch 

a widget that was not fetched at application startup. FETCH WIDGET 
can be used to defer fetching pop-up widgets until they are first referenced 
(presumably in a callback), and then can be used to fetch a widget one 
time. 


FETCH WIDGET can also create multiple instances of a widget (and its 
subtree). In this case, the UID definition functions as a template; a widget 
definition can be fetched any number of times. This can be used to make 
multiple instances of a widget, for example, in a dialog box or menu. 
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FETCH WIDGET OVERRIDE 


Fetches any indexed widget. Overrides FETCH WIDGET arguments. 





VAX FORMAT _ siaitus = DWT$FETCH_WIDGET_OVERRIDE 
(hierarchy _id, index, parent_widget, override_name, 
override_args, override_num_args, widget_return, 
class_return) 


argument 

information Argument Usage Data Type Access Mechanism 
status integer longword write value 
hierarchy_id identifier longword read value 
index char string char string read descriptor 
parent_widget uns longword uns longword read reference 
override_name char string char string read descriptor 
override_args arglist uns longword read reference 
override_num_args integer longword read reference 
widget_return identifier longword write reference 
class_return word word write reference 





MIT C FORMAT status = DwtFetchWidgetOverride 
(hierarchy_id, index, parent_widget, override_name, 
override_args, override_num_args, widget_return, 
class_return) 


argument 
information int DwtFetchWidgetOverride (hierarchy id, index, parent_widget, 
override name, override_args, 
override num_args, 
widget_return, class_return) 
DRMHierarchy hierarchy_id; 


String index; 

Widget parent widget; 
String override name; 
ArgList override _ args; 

int override _num_args; 
Widget *widget_return; 
DRMType *class_ return; 
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RETURNS status 
The status return value. Possible status return values for this routine are 
as follows: 
Return Value Name Description 
DRMSuccess The operation succeeded. 
DRMNotFound The widget was not found in hierarchy. 
DRMFailure The operation failed. 





ARGUMENTS _hierarchy_id 


The identifier of the hierarchy that contains the interface definition. 


index 
The name of the widget to fetch. 


parent_widget 
The identifier of the parent widget. 


override_name 
The name to override the widget name. Use a null value if you do not 
want to override the widget name. 


override_args 

The override argument list that is the same as the override argument list 
for the intrinsic routine CREATE WIDGET. Use a null value if you do not 
want to specify the override argument list. 


The override argument list is appended to the existing argument list; the 
resulting argument list is passed to the widget creation routine. 


override_num_args 
The number of arguments in override_args. Use zero if you do not want 
to override the argument list. 


widget_return 
The identifier of the created widget. 


class_return 

The code identifying the widget class. This argument is used to distinguish 
the main window from the other XUI Toolkit widgets. This argument 
must be supplied, but its value is undefined and should not be used by the 
application. 
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DESCRIPTION FETCH WIDGET OVERRIDE is identical to FETCH WIDGET in all 
respects, except that it allows the caller to override the widget’s name and 
any arguments that FETCH WIDGET would otherwise retrieve from the 
DRM hierarchy or one of the default mechanisms. The override argument 
list is not limited to those arguments in the DRM hierarchy. 


The override arguments apply only to the widget fetched and returned by 
this routine; its children do not receive any override arguments. 
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INITIALIZE DRM 


Prepares an application to use the DRM facilities. 





VAX FORMAT void = DWTSINITIALIZE_DRM () 





MIT C FORMAT void =DwitinitializeDRM () 


argument 
information void DwtInitializeDRM () 





DESCRIPTION _ INITIALIZE DRM prepares an application to use the DRM facilities. 
INITIALIZE DRM must be called before the following operations: 


¢ Widget creation, whether by the DRM or directly by the application 
¢ Calls to the intrinsic routine INITIALIZE or REGISTER CLASS 


INITIALIZE can be called more than once; however, all calls after the first 
have no effect. 


The toolkit class records that INITIALIZE DRM uses to initialize its 
facilities must be uninitialized. INITIALIZE DRM must be called before 
any calls to the intrinsic routines INITIALIZE, TOOLKIT INITIALIZE, 
DISPLAY INITIALIZE, and APPLICATION CREATE SHELL. 


DRM Routines 
OPEN HIERARCHY 


OPEN HIERARCHY 


Opens all the UID files in the DRM hierarchy. 





VAX FORMAT _ siatus=DWT$OPEN_HIERARCHY 
(num_files, file_names_list, ancillary_structures_list, 
hierarchy_id_return) 


argument 

information Argument Usage Data Type Access Mechanism 
status integer longword write value 
num_files word longword read reference 
file_names_list array uns longword read reference 
ancillary_structures_list record uns longword read reference 
hierarchy_id_return identifier longword write reference 





MIT C FORMAT status = DwtOpenHierarchy 
(num_files, file_names_list, ancillary_structures_list, 
hierarchy_id_return) 





argument 
information int DwtOpenHierarchy(num_files, file names list, 
ancillary structures list, 
hierarchy _id_ return) 
DRMCount num files; 
String *file names_list; 
IDBOSOpenParamPtr *ancillary_structures_list; 
DRMHierarchy *hierarchy id return; 
RETURNS status 
The status return value. Possible status return values for this routine are 
as follows: 
Return Value Name Description 
DRMSuccess — The operation succeeded. 
DRMNotFound One or more of the specified files were not 
found. 
DRMFailure The operation failed. 
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ARGUMENTS _ num_files 


The number of file names in file names list. 


file_names_list 


An array of pointers to the character strings. 


ancillary_structures_list 

A list of data structures that can be used to specify system-dependent 
information about the files in file_names_list. This argument is optional; 
a null value should be used if it is to be omitted. 


If this argument is specified, each data structure corresponds to a file . 
name in the file names list. In the VMS operating system, you can use 
this argument to specify an RMS default file name or related file name to 
be applied to each file name in the file names list. See the DwtAppl.h file 
for the definition of this data structure (IDBOSOpenParam). 


hierarchy_id_return 
The identifier of the DRM hierarchy. 





DESCRIPTION OPEN HIERARCHY opens all the UID files in the DRM hierarchy. It 
initializes the internal data structures that the DRM uses to manage the 
hierarchy. All files named in file names_list are closed if any errors 
occur. 
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REGISTER CLASS 


Provides the DRM with the information about a widget class defined by the 
application. 





VAX FORMAT __ siatus =DWT$REGISTER_CLASS 
(class_code, class_name, create_name, create_proc, 
class_record) 


argument 

information Argument Usage Data Type Access Mechanism 
status integer longword write value 
class_code longword longword read reference 
class_name char string char string read descriptor 
create_name char string char string read descriptor 
create_proc void_proc procedure entry mask read value 
class_record record longword read reference 





MIT C FORMAT _siatus = DwtRegisterClass 
(class_code, class_name, create_name, create_proc, 
class_record ) 





argument 
information int DwtRegisterClass(class code, class name, create_name, 
create proc, class_record) 
DRMType class code; 
String class_name; 
String create name; 
Widget (* create proc) (); 
WidgetClass class_ record; 
RETURNS status 
The status return value. Possible status return values for this routine are 
as follows: 
Return Value Name Description 
DRMSuccess The operation succeeded. 
DRMFailure The operation failed. 
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ARGUMENTS ~ class_code 
Defined as DRMwcUnknown for all application-defined widgets. 


class_name 


The case-sensitive name of the class. 


create_name 
The case-sensitive name of the low-level widget creation routine as it 
appears in the UIL module that defines a widget of this widget class. 


For application-defined widgets, create_name is the name of the creation 
procedure in the DIL module that defines this widget. 


create_proc 


The address of the low-level widget creation routine for this widget class. 


class_record 
The address of the class record for this widget class. 





DESCRIPTION REGISTER CLASS is called when the application uses an application- 
defined widget class. REGISTER CLASS provides the DRM with the 
information about an application-defined widget class, such as the class 
record and class name, that is necessary to create widgets of this class. 
This information is used by the DRM when a user-defined widget, as 
defined in a UIL module, is fetched from a DRM hierarchy. 


The class and superclass records used by REGISTER CLASS must be 
uninitialized. REGISTER CLASS must be called before any calls to 
the intrinsic routines INITIALIZE, TOOLKIT INITIALIZE, DISPLAY 
INITIALIZE, and APPLICATION CREATE SHELL, and before any 
widgets in the class are created. 


4—26 


DRM Routines 
REGISTER DRM NAMES 


REGISTER DRM NAMES 


Registers a vector of names of identifiers or callback routines for access in 
DRM. 





VAX FORMAT _ siatus = DWT$REGISTER_DRM_NAMES 
(register_list, register_count) 


argument 

information Argument Usage Data Type Access Mechanism 
status integer longword write value 
register_list array uns longword read reference 
register_count word word read reference 





MIT C FORMAT _ status = DwtRegisterDRMNames 
(register_list, register_count) 





argument 
information int DwtRegisterDRMNames (register list, register count) 
DRMRegisterArglist register _list; 
DRMCount register count; 
RETURNS status 
The status return value. Possible status return values for this routine are 
as follows: 
Return Value Name Description 
DRMSuccess The operation succeeded. 
DRMFailure The operation failed. 





ARGUMENTS __ register_list 
A list of name/value pairs for the names to be registered. Each name 
is a case-sensitive, null-terminated ASCII string. Each value is a 32-bit 
quantity, interpreted as a procedure address if the name is a callback 
routine, and uninterpreted otherwise. 


The data structure used to pass the name/value pairs can be found in 
DwtAppl.h. 
register_count 


The number of entries in register_list. 
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DESCRIPTION REGISTER DRM NAMES registers a vector of names and associated 
values for access in the DRM. The values can be callback routines, pointers 
to user-defined data, or any other values. The information provided is 
used to associate symbolic names occurring in UID files to their run-time 
values. For callbacks, this information provides the procedure address 
required by the XUI Toolkit to perform callbacks. For names used as 
identifiers in UIL, this information provides any run-time mapping the 
application needs. 





The names in the list are case sensitive. 


Callback routines registered through this REGISTER DRM NAMES 
may be either regular or creation callbacks. Regular callbacks have 
declarations determined by the XUI Toolkit. Creation callbacks have the 
same format as any other callback: 


void CallBackProc (widget_id, tag, callback_data) 


Widget *widget_id; 

Opaque tag; 

DwtAnyCallbackStruct *callback_data; 
widget_id The widget identifier (as in any callback routine). 
tag The specified tag value (as in any callback routine). 


caliback_data Always DwtCRCreate. 


As in any other callback, the widget name and parent are available from 
the widget record by way of widget_id. 


REGISTER DRM NAMES can be called at any time, either before or after 
calls to INITIALIZE DRM or REGISTER CLASS. The same name can be 
registered more than once if the associated value is changed each time, 
much like changing the value of a variable. 
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5, Compound String Routines 


The XUI Toolkit provides a set of compound string routines that enables 
the creation and manipulation of compound strings and font lists. 


A compound string is a sequence of segments. Each segment consists 
of a natural language identifier, a text direction identifier, rendition 
information, a character set identifier, and a counted text string. 


A font list is an array of font structures indexed by the character 

set identifier. A character set identifier is a constant from the file 
CDA$DEF type, where type is a language’s include file type. For example, 
H is the include file type for the C programming language. 


For concepts related to compound string routines and information about 
how to use them, see the VMS DECwindows Guide to SPREE, 
Programming. 


Table 5-1 lists the supported compound string routines. 


Table 5-1 Compound String Routines 


Routine Name 


ADD FONT LIST 
CREATE FONT LIST 
CS BYTE CMP 


CS CAT 


CS COPY 
CS EMPTY 


CS LEN 


CS STRING 
GET NEXT SEGMENT 


INIT GET SEGMENT 


LATIN1 STRING 


STRING 


Description 


Adds an eniry to a font list. 
Creates a new font list. 


Compares two compound strings to determine 
if they are identical. 


Appends a copy of a compound string to the 
end of another compound string. 


Copies a compound string. 


Determines if the compound string contains 
any text segments. 


Returns the number of bytes in a compound 
string. 


Creates a compound string. 


Gets information about the next segment of 
the compound string. 


Initializes the context needed by GET NEXT 
SEGMENT. 


Creates a compound string for the LATIN1 
character set. 


Creates a compound string by using a simpler 
interface than CS STRING. 
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Compound String Routines 
5.1 Compound String Routines 


Compound String Routines 
The following pages describe the XUI Toolkit compound string routines. 
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Compound String Routines 
ADD FONT LIST 


ADD FONT LIST 


Adds an entry to a font list. 





VAX FORMAT __ font_list=DWT$ADD_FONT_LIST 
(list, font, charset) 


argument 

information Argument Usage Data Type Access Mechanism 
font_list font list uns longword write value 
list font list uns longword read value 
font font uns longword read reference 
charset longword uns longword read reference 





MIT C FORMAT _font_list = DwtAddFontList 
(list, font, charset) 





argument 

information DwtFontList DwtAddFontList (list, font, charset) 
DwtFontList list; 
XFontStruct *font; 
unsigned long charset; 

RETURNS font_list 


The new font list. 





ARGUMENTS __ list 
A pointer to the font list to which an entry will be added. 


font 
A pointer to the font structure to be added to the list. 


charset 
The character set identifier for the font. 





DESCRIPTION ADD FONT LIST adds an entry to a font list and allocates space for a 
new font list. The space for the resulting font list is allocated within the 
routine; the space should be freed with the intrinsic routine FREE after 
use. 
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Compound String Routines 
CREATE FONT LIST 


CREATE FONT LIST 


Creates a new font list. 





VAX FORMAT __ font_list=DWT$CREATE_FONT_LIST 
| (font, charset) 


argument 

information Argument Usage Data Type Access Mechanism 
font_list font list uns longword __ write value 
font font uns longword read reference 
charset uns longword uns longword read — reference 





MIT C FORMAT font_list = DwtCreateFontList 
(font, charset) 





argument 

information DwtFontList DwtCreateFontList (font, charset) 
XFontStruct *font; 
unsigned long charset; 

RETURNS font_list 


The new font list. Returns a null value if the font specified in font is null. 





ARGUMENTS _ font 


A pointer to a font structure for which a new font list is generated. 


charset 
The character set identifier for the font. 





DESCRIPTION CREATE FONT LIST creates a new font list for the font and character 
set. CREATE FONT LIST allocates the space for the font list; the space 
allocated should be freed with the intrinsic routine FREE after use. The 

end of font list is marked by an element whose character set value is —1. 


Compound String Routines 
CS BYTE CMP 


CS BYTE CMP 


Compares two:compound strings to determine if they are identical. 





VAX FORMAT _ status=DWT$CSBYTECMP (compound_string1, 
compound_string2) 


argument 

information Argument Usage Data Type Access Mechanism 
status uns longword uns longword write value 
compound_string1 comp string uns longword read reference 
compound_string2 comp string uns longword read reference 





MIT C FORMAT status =DwtCSbytecmp (compound_string1, 
compound_string2) 





argument 

information int DwtCSbytecmp(compound_stringl, compound_string2) 
DwtCompString compound_stringl, compound_string2; 

RETURNS status 


The status return value. 


The status return value is zero if compound_string] and 
compound_string2 are exactly the same, or one if they are not the same. 





ARGUMENTS  compound_string1 


The compound string to be compared with compound_string2. 


compound_string2 


The compound string to be compared with compound_string]1. 





DESCRIPTION CS BYTE CMP compares two compound strings to determine if they 
are identical. The value returned is zero if compound_string1 and 
compound_string2 are exactly the same (byte to byte), or one if they are 
not the same. 
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Compound String Routines 
CS CAT 


CS CAT 


Appends a copy of a compound string to the end of another compound string. 





VAX FORMAT _ status =DWT$CSTRCAT 
(compound_string1, compound_ nee 
compound_string_result) 


status = DWT$CSTRNCAT 
(compound_string1, compound_string2, 
compound_string_result, num_chars) 


argument 

information Argument Usage Data Type Access Mechanism 
status uns longword uns longword _ write value 
compound_string1 comp string uns longword read reference 
compound_string2 comp string uns longword read reference 
compound_string_ pointer to uns longword write reference 
result comp string 
num_chars uns longword uns longword read reference 





MIT C FORMAT comp_string = DwtCSircat 
(compound_string1, compound_string2) 


comp_string = DwtCStrncat 
(compound_string1, compound_string2, num_chars) 





argument 
information DwtCompString DwtCStrcat (compound_stringl, compound_string2) 
DwtCompString DwtCStrncat (compound_stringl, compound_string2, 
num_chars) 
DwtCompString compound_stringl, compound_string2; 
int num_chars; 
RETURNS status (VAX only) 


The status return value. 


DwtSuccess is returned for normal completion. 


comp_string (C only) 


A pointer to the resulting compound string. 
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Compound String Routines 
CS CAT 





ARGUMENTS 


compound_string1 
The string to which a copy of compound_string2 is appended. 


compound_string2 
The string appended to the end of compound_string1. 


compound_string_result (VAX only) 


The resulting compound string. 


num_chars 
The maximum number of characters to append. 





DESCRIPTION 


CS TRCAT appends a copy of a compound string to the end of another 
compound string. CS TRCAT appends compound_string2 to the end of 
compound_string! and returns the resulting string. The original strings 
are preserved. The space for the resulting string is allocated within the 
routine; the space should be freed with the intrinsic routine FREE after 
use. 


CS TRNCAT appends no more than the number of characters specified in 
num_chars, including the headers and trailers of the compound string. 
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Compound String Routines 





CS COPY 
CS COPY 
Copies a compound siring. 
VAX FORMAT _ status =DWT$CSTRCPY 
(compound_string1, compound_string_result) 
status = DWT$CSTRNCPY 
(compound_string1, compound_string_result, 
num_chars) 
argument 


information 


Argument Usage Data Type Access Mechanism 


status uns longword uns longword write value 
compound_string1 comp string uns longword read reference 
compound_string_ pointer to uns longword write reference 
result comp string 

num_chars uns longword uns longword read reference 





MIT C FORMAT 


argument 
information 


comp_string = DwtCStrcpy 
(compound_string1) 


comp_string = DwtCSirncpy 
(compound_string1, num_chars) 


DwtCompString DwtCStrcpy (compound_string1l) 
DwtCompString DwtCStrncpy (compound_stringl, num_chars) 
DwtCompString compound_stringl]l; 
int num_chars; 





RETURNS 
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status (VAX only) 


The status return value. 


DwtSuccess is returned for normal completion. 


comp_string (C only) 


A pointer to the resulting compound string. 


Compound String Routines 
CS COPY 





ARGUMENTS 


compound_string1 


A compound string to be copied. 


compound _string_result (VAX only) 


A pointer to the resulting compound string. 


num_chars 


The number of characters to be copied. 


If the maximum number of characters is fewer than the number of 
characters in compound_string2, the resulting string is not a valid 
compound string. 





DESCRIPTION 


CS TRCOPY copies a compound string and returns a pointer to the copy. 
CS TRNCOPY copies exactly the number of characters in num_chars, 
including the headers and trailers. 


The space for the resulting string is allocated within the routine; the space 
should be freed with the intrinsic routine FREE after use. 
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Compound String Routines 
CS EMPTY 


CS EMPTY 


Determines if the compound string contains any text segments. 





VAX FORMAT _~ status=DWT$CSEMPTY (compound_string) 


argument 


information Argument -—~«sUsage=—~CSata Type Access. Mechanism 


status uns longword uns longword write value 
compound_siring comp string uns longword read reference 





MIT C FORMAT status =DwtCSempty (compound_string) 





argument 

information int DwtCSempty (compound_string) 
DwtCompString compound_string; 

RETURNS status 


The status return value. 


The value is 1 if all segments in compound_string have a zero text size; 
otherwise, the value is zero. 





ARGUMENTS compound_string 


The compound string. 





DESCRIPTION CS EMPTY determines if the compound string contains any text segments 
that are not empty. 
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Compound String Routines 





CS LEN 

Returns the number of bytes in a compound string. 

VAX FORMAT /ength=DWT$CSTRLEN (compound_string) 

argument 

information Argument Usage Data Type Access Mechanism 
length pointer to comp uns longword write reference 

string 

compound_siring comp string uns longword read reference 





MITC FORMAT /ength=DwtCStrlen (compound_siring) 





argument 

information int DwtCStrlen(compound_string) 
DwtCompString compound_string; 

RETURNS length 


The number of bytes in compound_string, including compound string 
headers and trailers. If the compound string has an invalid structure, zero 
is returned. 





ARGUMENTS compound_string 


The compound string whose length is being determined. 





DESCRIPTION CSLEN returns the number of bytes in compound_string, including 
compound string headers and trailers. 
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Compound String Routines 
CS STRING 


CS STRING 





Creates a compound string. 


VAX FORMAT _ status =DWT$CS_STRING 
(text, charset, dir_r_to_l, language, rend, 
compound_string) 
argument 
information Argument Usage Data Type Access Mechanism 
status uns longword uns longword write value 
text char string char string read descriptor 
charset uns longword uns longword read reference 
dir_r_to_| uns long uns longword read reference 
language uns longword uns longword read reference 
rend uns longword uns longword read reference 
compound_string pointer to comp uns longword write reference 


string 





MITC FORMAT comp _string = DwtCSString 
(text, charset, dir_r_to_l, language, rend) 





argument 
information DwtCompString DwtCSString(text, charset, dir_r_to_l, 
language, rend) 
char *text; 
unsigned long charset; 
int is al olin out oo ae 
unsigned long language; 
DwtRendMask rend; 
RETURNS Status (VAX only) 


The status return value. 


DwtSuccess is returned for normal completion. 


comp_string (C only) 
The resulting compound string. A null pointer is returned if the input 
string is null. 
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Compound String Routines 
CS STRING 





ARGUMENTS 


text 


The text string to be converted to a compound string. 


charset 

The character set identifier. Values for this argument can be found 
in the require file CDA$DEF with a file extension of the appropriate 
programming language. 


dir_r_to_l 

The direction in which the compound string is specified. Has a value of 1 
if the text is drawn right to left, or a value of zero if the text is drawn left 
to right. 


language 
Reserved by DIGITAL. 


rend 
Reserved by DIGITAL. 


compound_string (VAX only) 


The resulting compound string. 





DESCRIPTION 


CS STRING creates a compound string from information in the argument 
list. 


Space for the resulting string is allocated within the routine; the space 
should be freed with the intrinsic routine FREE after use. 
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Compound String Routines 
GET NEXT SEGMENT 


GET NEXT SEGMENT 


Gets information about the next segment in the compound string. 





VAX FORMAT 


argument 


information 


status = DWT$GET_NEXT_SEGMENT 
(context, text, text_len, charset, dir_r_to_l, lang, rend) 


Argument 


status 
context 
text 
text_len 
charset 
dir_r_to_| 
lang 

rend 


Usage 


uns longword 
uns longword 
char string 
uns longword 
uns longword 
uns long 

uns longword 
uns longword 


Data Type Access Mechanism 
uns longword write value 

uns longword modify reference 
char string write descriptor 
uns longword write reference 
uns longword write reference 
uns longword __ write reference 
uns longword __ write reference 
uns longword __ write reference 





MIT C FORMAT status = DwtGetNextSegment 
(context, text, charset, dir_r_to_l, lang, rend) 





argument 
information int DwtGetNextSegment (context, text, charset, 
dir _r_to_1, lang, rend) 
DwtCompStringContext *context; 
char Aktext; 
unsigned long *charset; 
int *dlrvr tol 
unsigned long *lang; 
DwtRendMask *rend; 
RETURNS status 
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The status return value. Possible status return values for this routine are 


as follows: 


Return Value Name 


DwtEndCS 


DwiFail 


Description 


The context is at the end of the compound 
string. 


The context is not valid. 


Compound String Routines 
GET NEXT SEGMENT 


Return Value Name Description 
DwtSuccess Normal completion. 
DwtTruncate (VAX only) The text string was truncated to fit in the buffer 


described by the static descriptor. 





ARGUMENTS 


context 

The context for the call to GET NEXT SEGMENT. Context is initialized 
by the INIT NEXT SEGMENT call and is updated every time GET NEXT 
SEGMENT is called. 


text 
The text in the next segment. 


text_len (VAX only) 
The length of the text in the next segment. 


charset 


The character set in the next segment. 


dir_r_to_! 
The direction for the next segment. Has a value of 1 if the text is drawn 
right to left, or a value of zero if the text is drawn left to right. 


lang 
Reserved by DIGITAL. 


rend 
Reserved by DIGITAL. 





DESCRIPTION 


GET NEXT SEGMENT gets information about the next segment of the 
compound string as determined by the context. 


For the C format, the space for the returned text string is allocated within 
the routine. The space should be freed with the intrinsic routine FREE 
after use. 
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Compound String Routines 
INIT GET SEGMENT 


INIT GET SEGMENT 


Initializes the context needed by GET NEXT SEGMENT. 





VAX FORMAT _ status = DWTSINIT_GET_SEGMENT 
(context, compound_string) 


argument 

information Argument Usage Data Type Access Mechanism 
status uns longword uns longword _ write value 
context uns longword uns longword __ write reference 
compound_string comp string uns longword read reference 





MIT C FORMAT status = DwtinitGetSegment 
(context, compound_string) 





argument 
information int DwtInitGetSegment (context, compound_string) 
DwtCompStringContext *context; 
DwtCompString compound string; 
RETURN status 
The status return value. Possible status return values for this routine are 
as follows: 
Return Value Name Description 
DwtSuccess Normal completion. 
DwtEndCS The string specified is null. 
DwtFail The string specified is not a compound string. 





ARGUMENTS ~ context 
The context to be filled by the routine. It should have been previously 


allocated by the user. 


compound_string 
The compound string. 
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Compound String Routines 
INIT GET SEGMENT 





DESCRIPTION _ INIT GET SEGMENT returns the initialized DwtCompStringContext, 
context, of the compound string, compound_string. The returned 
context is needed for calling GET NEXT SEGMENT. 
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Compound String Routines 
LATIN1 STRING 


LATIN1 STRING 


Creates a compound string for the LATIN1 character set. 





VAX FORMAT _ status =DWT$LATIN1_STRING 
(text, compound_string) 


argument 
information Argument Usage | Data Type Access Mechanism 
status uns longword uns longword _ write value 
text char string char string read descriptor 
compound_string pointer to comp uns longword write reference 
string 





MIT C FORMAT comp_siring = DwtLatin1 String 





(text) 
argument 
information DwtCompString DwtLatinlString (text) 
char *text; 
RETURNS status (VAX only) 


The status return value. 


DwtSuccess is returned on normal completion. 


comp_string (C only) 
The resulting compound string. It has the following default values: 


character set = CDA$K_ISO_LATIN1 
dirRtoL = Zero (LtoR) 

Language = DwtLanguageNotSpecified 
rendition = DwtRendMaskNone 





ARGUMENTS __ text 


The text string to be converted to a compound string. 


compound_string(VAX only) 


The resulting compound string. It has the following default values: 


character set = CDA$K_ISO_LATIN1 
dirRtoL = Zero (LtoR) 

Language = DwtLanguageNotSpecified 
rendition = DwtRendMaskNone 


Compound String Routines 
LATIN1 STRING 


ty 


DESCRIPTION LATIN1 STRING creates a compound string for the LATIN1 character 
set. LATIN1 STRING is provided for application programmers who do 
not need to mix compound strings containing different character sets and 
directions. LATIN1 STRING assumes the character encoding of the text to 
be ISO_LATIN1 and the writing direction to be from left to right. 


The space for the resulting compound string is allocated within the 
routine; the space should be freed with the intrinsic routine FREE after 
use. 
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Compound String Routines 
STRING 


STRING 


Creates a compound string. 





VAX FORMAT _ status = DWT$STRING 
(text, charset, dir_r_to_l, compound_string) 


argument 

information Argument Usage Data Type Access Mechanism 
status uns longword uns longword __ write value 
text char string char string read descriptor 
charset uns longword uns longword read reference 
dir_r_to_| uns long uns longword read reference 
compound_string pointer to comp uns longword write reference 

string 





MITC FORMAT comp_siring = DwtString 
(text, charset, dir_r_to_l) 





argument 

information DwtCompString DwtString(text, charset, dir_r to_l) 
char *ktext; 
unsigned long charset; 
int dit to" 

RETURNS status (VAX only) 


The status return value. 
DwtSuccess is returned on normal completion. 
comp_string (C only) 


The resulting compound string. A null pointer is returned if the text is 
null. 





ARGUMENTS __ text 


The text to be converted to a compound string. 


charset 

The character set identifier. Values for this argument can be found in the 
required file CDA$DEF with a file type of the appropriate programming 
language. 
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Compound String Routines 
STRING 


dir r_to_l 
The direction of the compound string. Has a value of 1 if the text is drawn 
right to left, or a value of zero if the text is drawn left to right. 


compound_string (VAX only) 


The resulting compound string. 





DESCRIPTION = STRING creates a compound string. It has a simpler interface than CS 
STRING. 


STRING assumes the following default values: 
e Language = DwtLanguageNotSpecified 
¢ rendition = DwtRendMaskNone 


The space for the resulting compound string is allocated within the 
routine; the space should be freed with the intrinsic routine FREE after 


use. 
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Cut and Paste Routines 


An application can interface to the clipboard through calls to the cut and 
paste routines. The following menu items represent features normally 
provided for user access to the clipboard: 


Cut When the user chooses this item, the application calls BEGIN COPY TO 
CLIPBOARD, COPY TO CLIPBOARD, and END COPY TO CLIPBOARD to 
copy the data in whatever formats it desires. The application then deletes 
the cut data from the user’s display. The application should save the deleted 
data if it is providing an UNDO CUT function. 


Copy The same as Cut except the data is not deleted. 


Paste When the user chooses this item, the application calls COPY FROM 
CLIPBOARD to get the data in some format. The application then allows the 
user to place the data on the display. 


Following is a list of actions that your application can provide to the user: 


Undo Cut The application redraws the deleted data. The application then 
calis UNDO COPY TO CLIPBOARD to delete the data from the 
clipboard. The application should not use the clipboard contents for 

_ redrawing the deleted data, as ihe user may have already changed 
the contents of the clipboard . 


Redo Cut The application performs the same actions as the Cut menu item. 

Undo Copy The application calls UNDO COPY TO CLIPBOARD. 

Redo Copy The application performs the same actions as the Copy menu item. 

Undo Paste The application deletes the pasted data and saves the pasted data 
for a possible later Redo Paste operation. 

Redo Paste The application pastes the data it saved during the Undo Paste 
operation. 


The clipboard is not involved with the Undo Paste or Redo Paste 
operations. During the interval between the Paste and the Undo Paste 
operations or between the Undo Paste and the Redo Paste operations, the 
clipboard might be changed either directly or indirectly by the user. 


For concepts related to cut and paste routines and information about 
how to use them, see the VMS DECwindows Guide to Application 
Programming. 


Table 6-1 lists the supported cut and paste routines. 
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Cut and Paste Routines 


Table 6—1 Cut and Paste Routines 


Routine Name 


BEGIN COPY TO CLIPBOARD 


CANCEL COPY FORMAT 


CANCEL COPY TO CLIPBOARD 


CLIPBOARD LOCK 


CLIPBOARD UNLOCK 


COPY FROM CLIPBOARD 
COPY TO CLIPBOARD 

END COPY TO CLIPBOARD 
INQUIRE NEXT PASTE COUNT 
INQUIRE NEXT PASTE FORMAT 


INQUIRE NEXT PASTE LENGTH 


LIST PENDING ITEMS 


RECOPY TO CLIPBOARD 


UNDO COPY TO CLIPBOARD 


Description 
Sets up storage and data structures to receive 
clipboard data. 


Indicates that the application will no longer 
supply a data item to the clipboard that the 
application had previously passed by name. 


Cancels the copy to clipboard that.is in 
progress. 


Locks the clipboard from access by other 
applications. 


Unlocks the clipboard, enabling it to be 
accessed by other applications. 


Retrieves a data item from the clipboard. 
Copies a data item to the clipboard. 
Places data in the clipboard data structure. 


Returns the number of data item formats 
available for the next-paste item in the 
clipboard. 


Returns a specified format name for the 
next-paste item in the clipboard. 


Returns the length of the data stored under a 
specified format name for the next-paste item 
in the clipboard. 


Returns a list of pending items as data 
ID/private ID pairs for a specified format name. 


Copies a data item that had been passed by 
name to the clipboard. 


Deletes the last item placed on the clipboard. 





6.1 Passing Data by Name 


Copying a large piece of data to the clipboard can take time. It is 
possible that, once copied, no application will ever request that data. 

An application does not need to actually pass data to the clipboard until 
the data has been requested by some application. Instead, the application 
passes format and length information to the clipboard routines, along 
with a widget identifier and a callback routine address. The widget 
identifier is needed for communications between the clipboard routines 
in the application that owns the data and the clipboard routines in the 
application that requests the data. Your callback routine is responsible 
for copying the actual data to the clipboard (with the RECOPY TO 
CLIPBOARD routine call). The callback routine is also called if the 
data item is removed from the clipboard, and the actual data is therefore 
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no longer needed. 


Cut and Paste Routines 
6.1 Passing Data by Name 


Refer to the BEGIN COPY TO CLIPBOARD, COPY TO CLIPBOARD, and 
RECOPY TO CLIPBOARD routines for more information on passing data 
by name. 





6.2 Cut and Paste Routines 
The following pages describe the XUI Toolkit cut and paste routines. 


Cut and Paste Routines 
BEGIN COPY TO CLIPBOARD 


BEGIN COPY TO CLIPBOARD 


Sets up storage and data structures to receive clipboard data. 





VAX FORMAT 


argument 


information 


status = DWT$BEGIN_COPY_TO_CLIPBOARD 
(display, window, clip_label, widget, callback, item_id) 


Argument 


status 
display 
window 


clip_label 


widget 


callback 


item_id 


Usage 


uns longword 
identifier 
identifier 
comp string 
identifier 

uns longword 
uns longword 


Data Type 


uns longword 
uns longword 
uns longword 
uns longword 
uns longword 
uns longword 
uns longword 


Access 


write 
read 
read 
read 
read 
read 
write 


Mechanism 


value 
reference 
reference 


reference 


reference 
reference 
reference 





MIT C FORMAT status = DwtBeginCopyToClipboard 
(display, window, clip_label, widget, callback, item_id) 


argument 


information 


int DwtBeginCopyToClipboard (display, window, clip label, 
widget, callback, item_id) 


Display *display; 
Window window; 
DwtCompString clip_label; 
Widget widget; 
VoidProc callback; 
unsigned long *item_id; 


Cut and Paste Routines 
BEGIN COPY TO CLIPBOARD 








RETURNS status 

The status return value. Possible status return values for this routine are 

as follows: 

Return Value Name Description 

ClipboardSuccess The routine is successful. 

ClipboardLocked The routine failed because the clipboard was 
locked by another application. The application 
can continue to try to call the routine again 
with the same parameters until the lock 
goes away. This gives the application the 
opportunity to ask if the user wants to keep 
trying or to give up on the operation. 

ARGUMENTS __ display 


A reference to the display information originally returned by the Xlib 
display routine OPEN DISPLAY. For more information about the Xlib 
routine OPEN DISPLAY, see the VMS DECwindows Xlib Routines 
Reference Manual. 


window 

The window identifier that relates the application window to the clipboard. 
The same application instance should pass the same window identifier to 
each clipboard routine that it calls. 


clip _label 

The label to be associated with the data item. This argument is used to 
identify the data item, for example, in a clipboard viewer. An example of 
a label would be the name of the application that places the data in the 
clipboard. 


widget 

The identifier of the widget that will receive messages requesting data 
previously passed by name. This argument must be present in order to 
pass data by name. 


Any valid widget identifier in your application can be used for this 
purpose and all the message handling is taken care of by the cut and 
paste routines. 


callback 


The address of the callback routine that is called when the clipboard needs 
data that was originally passed by name. This is also the callback to 
receive the DELETE message for items that were originally passed by 
name. This argument must be present in order to pass data by name. 


The callback format is as follows: 


routine (widget, data_id, private_id, reason) 
Widget *widget; 


int *data_id; 
int *private_id; 
int *reason; 
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Cut and Paste Routines 
BEGIN COPY TO CLIPBOARD 


The arguments in the callback format are defined as follows: 


widget The widget passed to BEGIN COPY TO CLIPBOARD. 


data_id The identifying number returned by COPY TO CLIPBOARD, which 
identifies the pass-by-name data. 


private_id The private information passed to COPY TO CLIPBOARD. 

reason Either DwtCRClipboardDataDelete or DwtCRClipboardDataRequest. 
item_id 

The number assigned to this data item. This number is used by 


the application in calls to COPY TO CLIPBOARD, END COPY TO 
CLIPBOARD, and CANCEL COPY TO CLIPBOARD. 





DESCRIPTION 
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BEGIN COPY TO CLIPBOARD sets up storage and data structures 

to receive clipboard data. An application calls BEGIN COPY TO 
CLIPBOARD during a cut or copy operation. The data item that these 
structures receive through calls to COPY TO CLIPBOARD then becomes 
the next item to be pasted (the next-paste item) in the clipboard after the 
call to END COPY TO CLIPBOARD. 


The widget_id and callback arguments must be present in order to pass 
data by name. 


Cut and Paste Routines 
CANCEL COPY FORMAT 


CANCEL COPY FORMAT 


Indicates that the application will no longer supply a data item to the clipboard 
that the application had previously passed by name. 





VAX FORMAT _ status =DWT$CANCEL_COPY_ FORMAT 
(display, window, data_id) 


argument 

information Argument Usage Data Type Access Mechanism 
status uns longword uns longword write value 
display identifier uns longword read reference 
window identifier uns longword read reference 
data_id uns longword —__ uns longword read reference 





MIT C FORMAT _ siatus = DwtCancelCopyFormat 
(display, window, data_id) 





argument | 
information int DwtCancelCopyFormat (display, window, data_id) 
Display *display; 
Window window; 
unsigned long data_id; 
RETURNS status 
The status return value. Possible status return values for this routine are 
as follows: 


Return Value Name Description 


ClipboardSuccess The routine is successful. 


ClipboardLocked The routine failed because the clipboard was locked by 
another application. The application can continue to try to 
call the routine again with the same parameters until the lock 
goes away. This gives the application the opportunity to ask 
if the user wants to keep trying or to give up on the operation. 
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Cut and Paste Routines 
CANCEL COPY FORMAT 





ARGUMENTS 


display 

A reference to the display information originally returned by the Xlib 
display routine OPEN DISPLAY. For more information about the Xlib 
routine OPEN DISPLAY, see the VMS DECwindows Xlib Routines 
Reference Manual. 


window 


The window identifier that relates the application window to the clipboard. 


_The same application instance should pass the same window identifier to 


each clipboard routine that it calls. 


data_id 

The number that uniquely identifies the data item and format. This 
was assigned to the item when it was originally passed by COPY TO 
CLIPBOARD. 





DESCRIPTION 


CANCEL COPY FORMAT indicates that the application will no longer 
supply a data item to the clipboard that the application had previously 
passed by name. 


For related information, see the routine LIST PENDING ITEMS. 


Cut and Paste Routines 
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CANCEL COPY TO CLIPBOARD 


Cancels the copy to clipboard that is in progress. 





VAX FORMAT void = DWT$CANCEL_COPY_TO CLIPBOARD 
(display, window, item_id) 


argument 

information Argument Usage Data Type Access Mechanism 
display identifier uns longword read reference 
window identifier uns longword read reference 
item_id uns longword uns longword read reference 





MIT C FORMAT void = DwtCancelCopyToClipboard 
(display, window, item_id) 


argument 

information void DwtCancelCopyToClipboard(display, window, item_id) 
Display *kdisplay; 
Window window; 


unsigned long item_id; 





ARGUMENTS _ display 


A reference to the display information originally returned by the Xlib 
display routine OPEN DISPLAY. For more information about the Xlib 
routine OPEN DISPLAY, see the VMS DECwindows Xlib Routines 
Reference Manual. 


window 

The window identifier that relates the application window to the clipboard. 
The same application instance should pass the same window identifier to 
each clipboard routine that it calls. 


item_id 
The number assigned to this data item. This number was returned by the 
previous call to BEGIN COPY TO CLIPBOARD. 





DESCRIPTION CANCEL COPY TO CLIPBOARD cancels the copy to clipboard that is in 
progress. This routine also frees temporary storage. 
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Cut and Paste Routines 
CANCEL COPY TO CLIPBOARD 


If CANCEL COPY TO CLIPBOARD is called, then END COPY FROM 
CLIPBOARD does not have to be called. A call to CANCEL COPY TO 
CLIPBOARD is valid only after a call to BEGIN COPY TO CLIPBOARD 
and before a call to END COPY TO CLIPBOARD. 


6-10 


Cut and Paste Routines 
CLIPBOARD LOCK 


CLIPBOARD LOCK 


Locks the clipboard from access by other applications. 





VAX FORMAT _ status =DWT$CLIPBOARD_LOCK 
(display, window) 


argument 

information Argument Usage Data Type Access Mechanism 
status uns longword uns longword write value 
display identifier uns longword read reference 
window identifier uns longword read reference 





MIT C FORMAT _ status = DwtClipboardLock 
(display, window) 





argument 
information int DwtClipboardLock (display, window) 
Display *display; 
Window window; 
RETURNS status 
The status return value. Possible status return values for this routine are 
as follows: 


Return Value Name Description 


ClipboardSuccess The routine is successful. 


ClipboardLocked The routine failed because the clipboard was locked by 
another application. The application can continue to try to 
call the routine again with the same parameters until the lock 
goes away. This gives the application the opportunity to ask 
if the user wants to keep trying or to give up on the operation. 





ARGUMENTS _ display 
A reference to the display information originally returned by the Xlib 
display routine OPEN DISPLAY. For more information about the Xlib 
routine OPEN DISPLAY, see the VMS DECwindows Xlib Routines 
Reference Manual. 
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Cut and Paste Routines 
CLIPBOARD LOCK 


window 

The window identifier that relates the application window to the clipboard. 
The same application instance should pass the same window identifier to 
each clipboard routine that it calls. 





DESCRIPTION CLIPBOARD LOCK locks the clipboard from access by another application 
until CLIPBOARD UNLOCK is called. All clipboard routines lock and 
unlock the clipboard to prevent simultaneous access. 


If the clipboard is already locked by another application, CLIPBOARD 
LOCK returns an error status. 


The CLIPBOARD LOCK and CLIPBOARD UNLOCK routines allow the 
application to keep the clipboard data from changing between calls to 
inquire routines and other clipboard routines. The application does not 
need to lock the clipboard between calls to BEGIN COPY TO CLIPBOARD 
and END COPY TO CLIPBOARD. 


Multiple calls to CLIPBOARD LOCK by the same application increase the 
lock level. See the Description section of CLIPBOARD UNLOCK. 
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Cut and Paste Routines 
CLIPBOARD UNLOCK 


CLIPBOARD UNLOCK 


Unlocks the clipboard, enabling it to be accessed by other applications. 





VAX FORMAT _ status =DWT$CLIPBOARD_UNLOCK 
(display, window, remove_all_locks) 


argument 

information Argument Usage Data Type Access Mechanism 
status uns longword uns longword write value 
display identifier uns longword read reference 
window identifier uns longword read reference 
remove_all_locks Boolean uns longword read reference 





MIT C FORMAT _siaius = DwtClipboardUnlock 
(display, window, remove_all_locks) 


argument 
information int DwtClipboardUnlock (display, window, remove_all_ locks) 
Display *display; 
Window window; 
Boolean remove_all_ locks; 





RETURNS status 


The status return value. Possible status return values for this routine are 
as follows: 


Return Value Name Description 


ClipboardSuccess The routine is successful. 


ClipboardLocked The routine failed because the clipboard was locked by 
another application. The application can continue to try to 
call the routine again with the same parameters until the lock 
goes away. This gives the application the opportunity to ask 
if the user wants to keep trying or to give up on the operation. 





ARGUMENTS _~— display 
A reference to the display information originally returned by the Xlib 
display routine OPEN DISPLAY. For more information about the Xlib 
routine OPEN DISPLAY, see the VMS DECwindows Xlib Routines 


Reference Manual. 
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Cut and Paste Routines 
CLIPBOARD UNLOCK 


window 
The window identifier that relates the application window to the clipboard. 
The same application instance should pass the same window identifier to 


each clipboard routine that it calls. 


remove_all_locks 
A value of true indicates that all nested locks should be removed. A value 
of False indicates that only one level of lock should be removed. 





DESCRIPTION 
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CLIPBOARD UNLOCK unlocks the clipboard, enabling it to be accessed 
by other applications. 

If multiple calls to CLIPBOARD LOCK have occurred, then the same 
number of calls to CLIPBOARD UNLOCK is necessary to unlock the 
clipboard, unless the remove_all_locks argument is true. 


Cut and Paste Routines 
COPY FROM CLIPBOARD 


COPY FROM CLIPBOARD 


Retrieves a data item from the clipboard. 





VAX FORMAT _ status = DWT$COPY_FROM_CLIPBOARD 


(display, window, format_name, buffer, num_bytes, 


private_id) 


argument 

information Argument Usage Data Type 
status uns longword uns longword 
display identifier uns longword 
window identifier uns longword 
format_name char string char string 
buffer char string char string 
num_bytes uns longword uns longword 
private_id longword longword 


Access 


write 
read 
read 
read 
write 
write 
write 


Mechanism 


value 

reference 
reference 
descriptor 
descriptor 
reference 
reference 





MIT C FORMAT _ status = DwtCopyFromClipboard 


(display, window, format_name, buffer, length, 


num_bytes, private_id) 


argument 
information int DwtCopyFromClipboard(display, window, format_name, buffer, 
length, num_bytes, private_id) 
Display *display; 
Window window; 
char *format_name; 
char *buffer; 


unsigned long length 
unsigned long *num_bytes; 
int *private_id; 
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Cut and Paste Routines 
COPY FROM CLIPBOARD 








RETURNS status 

The status return value. Possible status return values for this routine are 

as follows: 

Return Value Name Description 

ClipboardSuccess The routine is successful. 

ClipboardLocked The routine failed because the clipboard was locked by 
another application. The application can continue to try to 
call the routine again with the same parameters until the lock 
goes away. This gives the application the opportunity to ask 
if the user wants to keep trying or to give up on the operation. 

ClipboardTruncate The data returned is truncated because the user did not 
provide a buffer that was large enough to hold the data. 

ClipboardNoData The routine could not find data on the clipboard 
corresponding to the format requested. The following 
conditions could cause this result: 
¢ The clipboard is empty. 
¢ There is data on the clipboard but not in the requested 

format. 
¢ The data in the requested format was passed by name 
and is no longer available. 
ARGUMENTS | display 
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A reference to the display information originally returned by the Xlib 
display routine OPEN DISPLAY. For more information about the Xlib 
routine OPEN DISPLAY, see the VMS DECwindows Xlib Routines 
Reference Manual. 


window 
The window identifier that relates the application window to the clipboard. 


The same application instance should pass the same window identifier to 
each clipboard routine that it calls. 


format_name 


The name of a format in which the data is stored on the clipboard. 


buffer 
The buffer to which the application wants the clipboard to copy the data. 


length (C only) 
The length of the application buffer. 


num_bytes 
The number of bytes of data copied into the application buffer. 


private_id 

The private data stored with the data item by the application that placed 
the data item on the clipboard. If the application did not store private 
data with the data item, then this argument returns zero. 


Cut and Paste Routines 
COPY FROM CLIPBOARD 





DESCRIPTION 


COPY FROM CLIPBOARD retrieves the current next-paste item from 
clipboard storage. 


COPY FROM CLIPBOARD returns a warning under the following 
circumstances: 


e The data was truncated because the buffer length is too short. 
¢ The clipboard is locked. 


e¢ There is no data on the clipboard in the requested format. 
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Cut and Paste Routines 
COPY TO CLIPBOARD 


COPY TO CLIPBOARD 


Copies a data item to the clipboard. 





VAX FORMAT 


argument 
information 


status = DWT$COPY_TO CLIPBOARD 
(display, window, item_id, format_name, buffer, length, 


private_id, data_id) 


Argument 


status 
display 
window 
item_id 
format_name 
buffer 

length 
private_id 
data_id 


Usage 


uns longword 
identifier 
identifier 

uns longword 
char string 
char string 
uns longword 
longword 

uns longword 


Data Type 


uns longword 
uns longword 
uns longword 
uns longword 
char string 
char string 
uns longword 
longword 

uns longword 


Access 


write 
read 
read 
read 
read 
read 
read 
read 
write 


Mechanism 


value 

reference 
reference 
reference 
descriptor 
descriptor 
reference 
reference 
reference 





MIT C FORMAT status = DwtCopyToClipboard 
(display, window, item_id, format_name, buffer, length, 


private_id, data_id) 





argument 
information int DwtCopyToClipboard(display, window, item_id, format_name, 
buffer, length, private_id, data_id) 
Display *display; 
Window window; 
long item_id; 
char *format_name; 
char *buffer; 
unsigned long length; 
int private_id; 
unsigned long *data_id; 
RETURNS status 
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The status return value. Possible status return values for this routine are 


as follows: 


Cut and Paste Routines 
COPY TO CLIPBOARD 


Return Value Name Description 


ClipboardSuccess The routine is successful. 


ClipboardLocked The routine failed because the clipboard was locked by 
another application. The application can continue to try to 
call the routine again with the same parameters until the lock 
goes away. This gives the application the opportunity to ask 
if the user wants to keep trying or to give up on the operation. 





ARGUMENTS 


display 

A reference to the display information originally returned by the Xlib 
display routine OPEN DISPLAY. For more information about the Xlib 
routine OPEN DISPLAY, see the VMS DECwindows Xlib Routines 
Reference Manual. 


window 

The window identifier that relates the application window to the clipboard. 
The same application instance should pass the same window identifier to 
each clipboard routine that it calls. 


item_id 
The number assigned to this data item. This number was returned by the 
previous call to BEGIN COPY TO CLIPBOARD. 


format_name 
The name of the format in which the data item is stored. 


buffer 
The buffer from which the clipboard copies the data. 


length 
The length of the data being copied to the clipboard. 


VAX only 
The length argument is required only for data that is passed by name. 
private_id 


The private data stored with the data item by the application that placed 
the data item on the clipboard. 


data_id 

An identifying number assigned to the data item that uniquely identifies 
the data item and the format. This argument is required only for data 
that is passed by name. 





DESCRIPTION 


COPY TO CLIPBOARD copies a data item to clipboard storage. The data 
item is not actually entered in the clipboard data structure until the call to 
END COPY TO CLIPBOARD. Additional calls to COPY TO CLIPBOARD 
before a call to END COPY TO CLIPBOARD add data item formats to the 
same data item or append data to an existing format. 
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Cut and Paste Routines 
COPY TO CLIPBOARD 
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If the buffer parameter is null, the data is considered passed by name. 

If data passed by name is needed later by another application, the 
application that owns the data receives a callback with a request for 

the data. The application that owns the data must then transfer the 
data to the clipboard with the RECOPY TO CLIPBOARD routine.. When 
a data item that was passed by name is deleted from the clipboard, the 
application that owns the data receives a callback that states that the data 
is no longer needed. 


For information on the callback routine, see the callback argument 
description in BEGIN COPY TO CLIPBOARD. 


Cut and Paste Routines 
END COPY TO CLIPBOARD 


END COPY TO CLIPBOARD 


Places data in the clipboard data structure. 





VAX FORMAT __ status =DWT$END_COPY_TO_ CLIPBOARD 
(display, window, item_id) 


argument 

information Argument Usage Data Type Access Mechanism 
status uns longword uns longword write value 
display identifier uns longword read reference 
window identifier uns longword read reference 
item_id uns longword uns longword read reference 





MIT C FORMAT _ siaius = DwtEndCopyToClipboard 
(display, window, item_id) 





argument 
information int DwtEndCopyToClipboard(display, window, item_id) 
Display *display; 
Window window; 
unsigned long item_id; 
RETURNS status 
The status return value. Possible status return values for this routine are 
as follows: 


Return Value Name Description 


ClipboardSuccess The routine is successful. 


ClipboardLocked The routine failed because the clipboard was locked by 
another application. The application can continue to try to 
call the routine again with the same parameters until the lock 
goes away. This gives the application the opportunity to ask 
if the user wants to keep trying or to give up on the operation. 





ARGUMENTS _ display 


A reference to the display information originally returned by the Xlib 
display routine OPEN DISPLAY. For more information about the Xlib 
routine OPEN DISPLAY, see the VMS DECwindows Xlib Routines 
Reference Manual. 
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END COPY TO CLIPBOARD 


window 

The window identifier that relates the application window to the clipboard. 
The same application instance should pass the same window identifier to 
each clipboard routine that it calls. 


item_id 
The number assigned to this data item. This number was returned by the 
previous call to BEGIN COPY TO CLIPBOARD. 





DESCRIPTION 
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END COPY TO CLIPBOARD locks the clipboard from access by other 
applications, places data in the clipboard data structure, and unlocks the 
clipboard. Data items copied to the clipboard by COPY TO CLIPBOARD 
are not actually entered in the clipboard data structure until the call to 
END COPY TO CLIPBOARD. 


Cut and Paste Routines 


INQUIRE NEXT PASTE COUNT 





INQUIRE NEXT PASTE COUNT 


Returns the number of data item formats available for the next-paste item in 


the clipboard. 





VAX FORMAT 


status = DWT$INQUIRE_NEXT_PASTE_COUNT 
(display, window, count, max_format_name_len) 

argument 

information Argument Usage Data Type Access Mechanism 
status uns longword uns longword __ write value 
display identifier uns longword read reference 
window identifier uns longword read reference 
count uns longword uns longword write reference 
max_format_name_len — uns longword uns longword write reference 





MIT C FORMAT status = DwtinquireNextPasteCount 
(display, window, count, max_format_name_len) 





argument 
information int DwtInquireNextPasteCount (display, window, count, 
max_format_name_len) 
Display *display; 
Window window; 
unsigned long *count; 
unsigned long *max_format_name_len; 
RETURNS status 
The status return value. Possible status return values for this routine are 
as follows: 


Return Value Name Description 


ClipboardSuccess The routine is successful. 


ClipboardLocked The routine failed because the clipboard was locked by 
another application. The application can continue to try to 
call the routine again with the same parameters until the lock 
goes away. This gives the application the opportunity to ask 


if the user wants to keep trying or to give up on the operation. 
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Cut and Paste Routines 
INQUIRE NEXT PASTE COUNT 





ARGUMENTS 


display 

A reference to the display information originally returned by the Xlib 
display routine OPEN DISPLAY. For more information about the Xlib 
routine OPEN DISPLAY, see the VMS DECwindows Xlib Routines 
Reference Manual. 


window 

The window identifier that relates the application window to the clipboard. 
The same application instance should pass the same window identifier to 
each clipboard routine that it calls. 


count 

The number of data item formats available for the next-paste item in the 
clipboard. If no formats are available, this argument equals zero. The 
count includes formats that were passed by name. 


max_format_name_len 
The maximum length of all format names for the next-paste item in the 
clipboard. 





DESCRIPTION 
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INQUIRE NEXT PASTE COUNT returns the number of data item formats 
available for the next-paste item in the clipboard. INQUIRE NEXT PASTE 
COUNT also returns the maximum name length for all formats in which 
the next-paste item is stored. 


Cut and Paste Routines 
INQUIRE NEXT PASTE FORMAT 


INQUIRE NEXT PASTE FORMAT 


Returns a specified format name for the next-paste item in the clipboard. 








VAX FORMAT _ status =DWT$INQUIRE_NEXT PASTE_FORMAT 
(display, window, number, format_name_but, 
copied_len) 

argument 

information Argument Usage Data Type Access Mechanism 

status uns longword uns longword write value 
display identifier uns longword read reference 
window identifier uns longword read reference 
number uns longword —_ uns longword read reference 
format_name_buf — char string char string write descriptor 
copied_len uns longword uns longword write reference _ 

MIT C FORMAT status = DwtinquireNextPasteFormat 
(display, window, number, format_name_but, 
buffer_len, copied_len) 

argument 

information int DwtInquireNextPasteFormat (display, window, number, 


format_name_buf, buffer_len, 


copied_len) 


Display *display; 

Window window; 

int number; 

char *format_name_buf; 


unsigned long 
unsigned long 


buffer len; 
*copied_len; 
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INQUIRE NEXT PASTE FORMAT 





RETURNS status 


The status return value. Possible status return values for this routine are 
as follows: 


Return Value Name Description 


ClipboardSuccess The routine is successful. 


ClipboardLocked The routine failed because the clipboard was locked by 
another application. The application can continue to try to 
call the routine again with the same parameters until the lock 
goes away. This gives the application the opportunity to ask 
if the user wants to keep trying or to give up on the operation. 


ClipboardTruncate The data returned is truncated because the user did not 
provide a buffer that was large enough to hold the data. 





ARGUMENTS ~ display 


A reference to the display information originally returned by the Xlib 
display routine OPEN DISPLAY. For more information about the Xlib 
routine OPEN DISPLAY, see the VMS DECwindows Xlib Routines 
Reference Manual. 


window 

The window identifier that relates the application window to the clipboard. 
The same application instance should pass the same window identifier to 
each clipboard routine that it calls. 


number 

The number of the format name to be obtained. If this number is greater 
than the number of formats for the data item, then INQUIRE NEXT 
PASTE FORMAT returns a zero in the copied_len argument. 


format_name_buf 
The buffer that receives the format name. 


buffer_len (C only) 


The number of bytes in the format name buffer. 


copied_len 
The number of bytes in the string copied to the buffer. If this argument 
equals zero, then there is no nth format for the next-paste item. 





DESCRIPTION INQUIRE NEXT PASTE FORMAT returns a specified format name for the 
next-paste item in the clipboard. 


If the name must be truncated, then a warning status is returned. 
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INQUIRE NEXT PASTE LENGTH 


Returns the length of the data stored under a specified format name for the 
next-paste item in the clipboard. 














VAX FORMAT _ siatus = DWT$INQUIRE_NEXT_PASTE_LENGTH 
(display, window, format_name, length) 
argument 
information Argument Usage Data Type Access Mechanism 
status uns longword uns longword write value 
display identifier uns longword read reference 
window identifier uns longword read reference 
format_name char string char string read descriptor 
length uns longword uns longword write reference 
MIT C FORMAT status = DwtinquireNextPasteLength 
(display, window, format_name, length) 
argument 
information int DwtInquireNextPasteLength (display, window, format_name, 
length) 
Display *display; 
Window window; 
char *format_name; 
unsigned long *length; 
RETURNS status 


The status return value. Possible status return values for this routine are 
as follows: 


Return Value Name Description 


ClipboardSuccess The routine is successful. 


ClipboardLocked The routine failed because the clipboard was locked by 
another application. The application can continue to try to 
call the routine again with the same parameters until the lock 
goes away. This gives the application the opportunity to ask 
if the user wants to keep trying or to give up on the operation. 
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INQUIRE NEXT PASTE LENGTH 








ARGUMENTS _~ display 
A reference to the display information originally returned by the Xlib 
display routine OPEN DISPLAY. For more information about the Xlib 
routine OPEN DISPLAY, see the VMS DECwindows Xlib Routines 
Reference Manual. 
window 
The window identifier that relates the application window to the clipboard. 
The same application instance should pass the same window identifier to 
each clipboard routine that it calls. 
format_name 
The name of the format for the next-paste item. 
length 
The length of the next data item in the specified format. This argument 
equals zero if no data is found for the specified format or if there is no item 
on the clipboard. 

DESCRIPTION INQUIRE NEXT PASTE LENGTH returns the length of the data stored 


under a specified format name for the next-paste item in the clipboard. 


If no data is found for the specified format, or if there is no item on the 
clipboard, INQUIRE NEXT PASTE LENGTH returns a value of zero. | 


Note: Any format passed by name is assumed to have the length passed 
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in the call to COPY TO CLIPBOARD, even though the data has not 
been transferred yet to the clipboard in that format. 


Cut and Paste Routines 
LIST PENDING ITEMS 


LIST PENDING ITEMS 


Returns a list of pending items as data |D/private ID pairs for a specified 
format name. 





VAX FORMAT _ status =DWTS$LIST_PENDING_ITEMS 
(display, window, format_name, item_list, item_count) 

argument 

information Argument Usage Data Type Access Mechanism 
status uns longword uns longword write value 
display identifier uns longword read reference 
window identifier uns longword read reference 
format_name char string char string read descriptor 
item_list uns longword —_ uns longword write reference 
item_count uns longword uns longword write reference 





MIT C FORMAT _siatus = DwtListPendingltems 
(display, window, format_name, item_list, item_count) 





argument 
information int DwtListPendingItems (display, window, format_name, 
item list, item_count) 
Display *kdisplay; 
Window window; 
char *format_name; 
DwtClipboardPendingList *item_list 
unsigned long *xitem_ count; 
RETURNS status 
The status return value. Possible status return values for this routine are 
as follows: 


Return Value Name Description 


ClipboardSuccess The routine is successful. 


ClipboardLocked The routine failed because the clipboard was locked by 
another application. The application can continue to try to 
call the routine again with the same parameters until the lock 
goes away. This gives the application the opportunity to ask 


if the user wants to keep trying or to give up on the operation. 
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LIST PENDING ITEMS 





ARGUMENTS 


display 

A reference to the display information originally returned by the Xlib 
display routine OPEN DISPLAY. For more information about the Xlib 
routine OPEN DISPLAY, see the VMS DECwindows Xlib Routines 
Reference Manual. 


window 

The window identifier that relates the application window to the clipboard. 
The same application instance should pass the same window identifier to 
each clipboard routine that it calls. 


format_name 
A string containing the name of the format for which the list of data 
ID/private ID pairs is to be obtained. 


item_list 

The address of the array of data ID/private ID pairs for the specified 
format name. This parameter has a type of DwtClipboardPendingList. 
The application is responsible for freeing the memory provided by this 
routine for storing the list. 


item_count 

The number of items returned in the list. If there is no data for the 
specified format name, or if there is no item on the clipboard, this 
argument equals zero. 





DESCRIPTION 
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LIST PENDING ITEMS returns a list of pending items as data ID/private 

D pairs for a specified format name. For the purposes of this routine, a 
data item is considered pending if the application originally passed it by 
name, the application has not yet copied the data, and the item has not 
been deleted from the clipboard. 


The application is responsible for freeing the memory provided by this 
routine to store the list. 


This routine is used by an application when exiting to determine if the 
data that it passed by name should be sent to the clipboard. 


For related information, see the routines RECOPY TO CLIPBOARD and 
CANCEL COPY FORMAT. 


Cut and Paste Routines 
RECOPY TO CLIPBOARD 





RECOPY TO CLIPBOARD 


Copies a data item that had been passed by name to the clipboard. 





VAX FORMAT _ siatus=DWT$RECOPY_TO CLIPBOARD 
(display, window, data_id, buffer, private_id) 


argument 

information Argument Usage Data Type Access Mechanism 
status uns longword _—_uns longword write value 
display identifier uns longword read reference 
window identifier uns longword read reference 
data_id uns longword —_uns longword read reference 
buffer char string char string read descriptor 
private_id longword longword read reference 





MIT C FORMAT _s status = DwtReCopyToClipboard 
(display, window, data_id, buffer, length, ervaien: id) 





argument 
information int DwtReCopyToClipboard(display, window, data_id, 
buffer, length, private id) 
Display *display; 
Window window; 
unsigned long data_id; 
char *buffer; 
unsigned long length; 
int private_id; 
RETURNS status 
The status return value. Possible status return values for this routine are 


as follows: 


Return Value Name Description 


ClipboardSuccess The routine is successful. 


ClipboardLocked The routine failed because the clipboard was locked by 
another application. The application can continue to try to 
call the routine again with the same parameters until the lock 
goes away. This gives the application the opportunity to ask 
if the user wants to keep trying or to give up on the operation. 
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Cut and Paste Routines 
RECOPY TO CLIPBOARD 








ARGUMENTS _ display 
A reference to the display information originally returned by the Xlib 
display routine OPEN DISPLAY. For more information about the Xlib 
routine OPEN DISPLAY, see the VMS DECwindows Xlib Routines 
Reference Manual. 
window 
The window identifier that relates the application window to the clipboard. 
The same application instance should pass the same window identifier to 
each clipboard routine that it calls. 
data_id 
An identifying number assigned by COPY TO CLIPBOARD to the data 
item. This argument uniquely identifies the data item and the format. 
buffer 
The buffer from which the clipboard copies the data. 
length (C only) 
The number of bytes in the data item. 
private_id 
The private data stored with the data item by the application that placed 
the data item on the clipboard. 

DESCRIPTION £RECOPY TO CLIPBOARD copies the actual data for a data item that was 
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previously passed by name to the clipboard. Additional calls to RECOPY 
TO CLIPBOARD append new data to the existing data. 


RECOPY TO CLIPBOARD cannot be used to pass data by name. 


For related information, see the routines LIST PENDING ITEMS and 
CANCEL COPY FORMAT. 


Cut and Paste Routines 
UNDO COPY TO CLIPBOARD 


UNDO COPY TO CLIPBOARD 


Deletes the last item placed on the clipboard. 





VAX FORMAT _ status =DWT$UNDO_COPY_TO_ CLIPBOARD 
(display, window) 


argument 

information Argument Usage Data Type Access Mechanism 
status uns longword uns longword write value 
display identifier uns longword read reference 
window identifier uns longword read reference 





MIT C FORMAT status = DwtUndoCopyToClipboard 
(display, window) 





argument 
information int DwtUndoCopyToClipboard(display, window) 
Display *display; 
Window window; 
RETURNS status 
The status return value. Possible status return values for this routine are 
as follows: 


Return Value Name Description 


ClipboardSuccess The routine is successful. 


ClipboardLocked The routine failed because the clipboard was locked by 
another application. The application can continue to try to 
call the routine again with the same parameters until the lock 
goes away. This gives the application the opportunity to ask 
if the user wants to keep trying or to give up on the operation. 





ARGUMENTS _ display 
A reference to the display information originally returned by the Xlib 
display routine OPEN DISPLAY. For more information about the Xlib 
routine OPEN DISPLAY, see the VMS DECwindows Xlib Routines 
Reference Manual. 
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Cut and Paste Routines 
UNDO COPY TO CLIPBOARD 


window 

The window identifier that relates the application window to the clipboard. 
The same application instance should pass the same window identifier to 
each clipboard routine that it calls. 





DESCRIPTION UNDO COPY TO CLIPBOARD deletes the last item placed on the 
. clipboard if the item was placed there by an application with the passed 
display and window identifiers. Any data item deleted from the clipboard 
by the original call to COPY TO CLIPBOARD is restored. If the display 
or window identifiers do not match the last copied item, no action is taken 
and this routine has no effect. 
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High-Level Widget Routines 


The XUI Toolkit contains high-level run-time routines that allow 
application programmers to create and manipulate widgets. 


High-level widget creation routines implement the specific user interface 
for the application. The high-level routines allow the application to access 
common attributes needed in screen display, menus, input queries, and 
command functions. This set of high-level routines provides much of the 
DECwindows-style conforming screen display and user interface tools in 


building any application. 


The high-level widget manipulation routines allow the application 
programmer to manipulate widgets or obtain information from existing _ 


widgets. 


This chapter presents the high-level widget routines in alphabetical order. 
Table 7—1 lists the supported high-level widget routines. 


Table 7-1 High-Level Widget Routines 


Routine Name 


ATTACHED DIALOG BOX 
CAUTION BOX 
COMMAND APPEND 


COMMAND ERROR MESSAGE 


COMMAND SET 


COMMAND WINDOW 

DIALOG BOX 

FILE SELECTION 

FILE SELECTION DO SEARCH 


HELP 

LABEL 

LIST BOX 

LIST BOX ADD ITEM 
LIST BOX DELETE ITEM 


Description 


Creates an attached dialog box widget. 
Creates a caution box widget. 


Appends the passed string to the current 
command line and executes it, if required. 


Writes an error message in the command 
window and refreshes the command line. 


Replaces the current command string with the 
one passed. 


Creates a command window widget. 
Creates a dialog box widget. 
Creates a file selection widget. 


Initiates a search with a directory mask option. 
Otherwise, the current directory mask is used. 


Creates a help widget box. 

Creates a label widget. 

Creates a list box widget. 

Adds an item to the list within a list box widget. 
Deletes an item from the list within a list box 
widget. 


(continued on next page) 
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Table 7-1 (Cont.) High-Level Widget Routines 


Routine Name 


LIST BOX DELETE POS 


LIST BOX DESELECT ALL ITEMS 


LIST BOX DESELECT ITEM 


LIST BOX DESELECT POS 


LIST BOX ITEM EXISTS 


LIST BOX SELECT ITEM 
LIST BOX SELECT POS 


LIST BOX SET HORIZ POS 


_ LIST BOX SET ITEM 


LIST BOX SET POS 


MAIN WINDOW 
MAIN WINDOW SET AREAS 


MENU 
MENU BAR 
MENU POSITION 


MESSAGE BOX 

OPTION MENU 

PULL DOWN MENU ENTRY 

PULL DOWN MENU ENTRY HILITE 
PUSH BUTTON 

RADIO BOX 

SCALE 

SCALE GET SLIDER 


SCALE SET SLIDER 


Description 
Deletes an item identified by its position from 
the list within a list box widget. 


Cancels the selection of all previously selected 
items in a list box. 


Cancels the selection of a previously selected 
item in a list box. 


Cancels the selection of an item identified by 
its position in a list box. 


Verifies the existence of a particular item in a 
list box. 


Selects an item in the list box. 


Selects an item identified by its position in the 
list box. 


Sets the horizontal position to a specified 
position. 


Makes a specified item (if it exists) the first 
visible item in a list box, or as close to the top 
as possible. The item always becomes visible. 


Makes a specified position (item number in 
list) the top visible position in a list box, or as 
close to the top as possible. 


Creates a main window widget. 


Sets up or adds the menu bar, work window, 
command window, and scroll bar widgets to 
the main window widget of the application. 


Creates a menu widget. 
Creates a menu bar widget. 


Positions the pop-up menu when user presses 
MB2. 


Creates a message box widget. 
Creates an option menu widget. 
Creates a pull-down menu eniry widget. 
Creates a pull-down menu entry widget. 
Creates a push button widget. 

Creates a radio box widget. 

Creates a scale widget. 


Gets the current value of the slider position 
displayed in the scale. 


Sets or changes the current value of the slider 
position displayed in the scale. 


(continued on next page) 
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Table 7—1 (Cont.) High-Level Widget Routines 


Routine Name 


SCROLL BAR 
SCROLL BAR GET SLIDER 


SCROLL BAR SET SLIDER 


SCROLL WINDOW 
SCROLL WINDOW SET AREAS 


SELECTION 

SEPARATOR 

S TEXT 

S TEXT CLEAR SELECTION 


S TEXT GET EDITABLE 


S TEXT GET MAX LENGTH 


S TEXT GET SELECTION 


S TEXT GET STRING 


S TEXT REPLACE 


S TEXT SET EDITABLE 


S TEXT SET MAX LENGTH 


S TEXT SET SELECTION 


S TEXT SET STRING 


Description 


Creates a scroll bar widget. 


Retrieves the current size and position 
parameters of the slider in the scroll bar 
widget. 


Sets or changes the current size/position 
parameters of the slider in the scroll bar 
widget. 


Creates a scroll window widget. 


Specifies the widgets that are to serve as the 
work area, horizontal scoll bar, and vertical 
scroll bar widgets for the scoll window widget. 


Creates a selection widget. 
Creates a separator widget. 
Creates a simple text widget. 


Clears the global selection highlighted in the 
simple text widget. 


Obtains the current permission state 
concerning whether the text in the simple 
text widget can be edited by the user. 


Gets the current maximum allowable length of 
the text string in the simple text widget. 


Gets the global selection, if any, currently 
highlighted in the simple text widget. 

Gets the text string from the simple text 
widget. 


Replaces a portion of the current text string 
in the simple text widget or inserts a new 
substring in the text. 


Sets the permission state that determines 
whether the text in the widget can be edited 
by the user. 


Sets the maximum allowable length of the text 
string in the simple text widget. 


Makes specified text in the simple text widget 
the current global selection and highlights it in 
the simple text widget. 


Sets the text string in the simple text widget. 


(continued on next page) 


7-3 


7.1 


High-Level Widget Routines 


Table 7-1 (Cont.) High-Level Widget Routines 


Routine Name Description 
TOGGLE BUTTON Creates a toggle button widget. 

TOGGLE BUTTON GET STATE Gets the current state of the toggle button. 
TOGGLE BUTTON SET STATE Sets or changes the current state of the toggle 
button. 

WINDOW Creates a window widget. 
WORK BOX Creates a work box widget. 


High-Level Widget Routines 
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This section provides information about high-level widget routines. See 
Chapter 1 for a description of the format used in the routines. 


High-Level Widget Routines 
ATTACHED DIALOG BOX 


ATTACHED DIALOG BOX 


Creates an attached dialog box widget. 





VAX FORMAT 


argument 
information 


widget = DWT$ATTACHED_DB 
(parent_widget, name, default_position, x, y, title, style, 
map_callback, help_callback) 


Argument 


widget 
parent_widget 
name 
default_position 
x 

y 

title 

style 
map_callback 
help_callback 


Usage Data Type 
widget uns longword 
widget uns longword 
char string char string 
Boolean “uns longword 
position longword 
position longword 
comp string uns longword 


uns longword uns longword 


callback uns longword 


callback uns longword 


Access 


write 
read 
read 
read 
read 
read 
read 
read 
read 
read 


Mechanism 


value 

reference 
descriptor 
reference 
reference 
reference 
reference 
reference 
reference 
reference 





MIT C FORMAT widget = DwtAttachedDB 
(parent_widget, name, default_position, x, y, title, style, 
map_callback, help_callback) 


argument 
information 


Widget DwtAttachedDB (parent widget, name, default_position, 
x, y, title, style, map callback, 


help callback) 


Widget parent widget; 
char *name; 

Boolean default_position; 
Position x; 

Position Vi 

DwtCompString title; 

unsigned char style; 


DwtCallbackPtr map_callback; 
DwtCallbackPtr help callback; 
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High-Level Widget Routines 
ATTACHED DIALOG BOX 








RETURNS widget 
The identifier of the created widget. 
ARGUMENTS _ parent_widget 


The identifier of the parent widget. 


name 
The name of the created widget. 


default_position 

A Boolean attribute that, if true, causes the core attributes x and y to be 
ignored and forces the default widget position. The default widget position 
is centered in the parent window. If false, the specified x and y attributes 


are used to position the widget. This argument sets the default_position 
attribute described in the low-level routine DIALOG BOX CREATE. 


x 

The placement, in pixels, of the left side of the widget window relative to 
the inner upper left corner of the parent window. This argument sets the 
core widget x attribute described in Section 8.2. 


The placement, in pixels, of the top of the widget window relative to the 
inner upper left corner of the parent window. This argument sets the core 
widget y attribute described in Section 8.2. 


title 

The compound string label. The label is given to the window manager 
for the title bar if the style attribute described in the low-level routine 
DIALOG BOX POPUP CREATE is Modal or Modeless. 


style 

The style of the dialog box. There are three possible dialog styles: Modal 
and Modeless for pop-up attached dialog boxes and Workarea for regular 
attached dialog boxes. The predefined values for this attribute are as 
follows: 


VAX Cc Description 
DWT$C_MODAL DwtModal Modal 
DWT$C_MODELESS DwtModeless Modeless 
DWT$C_WORKAREA DwtWorkarea Work area 


This argument sets the style attribute described in the low-level routines 
DIALOG BOX CREATE and DIALOG BOX POPUP CREATE. 


map_callback 


A callback routine or routines called when a dialog box is about to be 
mapped. This argument is ignored if style is Workarea. 


help_callback 


The callback routine or routines called on a help request. 


High-Level Widget Routines 
ATTACHED DIALOG BOX 





DESCRIPTION See the low-level routine ATTACHED DIALOG BOX CREATE. 
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High-Level Widget Routines 
CAUTION BOX 





CAUTION BOX 


Creates a caution box widget for the application to display caution messages. 





VAX FORMAT 


argument 


information 


widget = DWT$CAUTION BOX 
(parent_widget, name, default_position, x, y, — 
Style, label, yes_label, no_label, cancel_label, 
default_push_button, callback, help_callback) 


Argument 
widget 
parent_widget 
name 


default_position 


x 
y 

style 

label 
yes_label 
no_label 
cancel_label 


default_push_button 


callback 
help_callback 


Usage 


widget 
widget 
char string 
Boolean 
position 
position 
uns longword 
comp string 
comp string 
comp string 
comp string 
longword 
callback 
callback 


Data Type 


uns longword 
uns longword 
char string 
uns longword 
longword 
longword 

uns longword 
uns longword 
uns longword 
uns longword 
uns longword 
longword 


_ uns longword 


uns longword 


Access Mechanism 


write value 

read reference 
read descriptor 
read reference 
read reference 
read reference 
read reference 
read reference 
read reference 
read reference 
read reference 
read reference 
read reference 
read reference 





MIT C FORMAT widget = DwtCautionBox 


(parent_widget, name, default_position, x, y, 
Style, label, yes_label, no_label, cancel_label, 
default_push_button, callback, help_callback) 


High-Level Widget Routines 
CAUTION BOX 








argument 
information Widget DwtCautionBox(parent_widget, name, default_position, 
xX, y, Style, label, yes_label, no_label, 
cancel label, default _push_button, 
callback, help callback) 
Widget parent_widget; 
char *name; 
Boolean default_position; 
Position xy 
Position yi 
unsigned char style; 
DwtCompString label; 
DwtCompSt ring yes_label; 
DwtCompString no_label; 
DwtCompString cancel label; 
int default_push_button 
DwtCallbackPtr callback; 
DwtCallbackPtr help callback; 
RETURNS widget 
The identifier of the created widget. 
ARGUMENTS _ parent_widget 


The identifier of the parent widget. 


name 
The name of the created widget. 


default_position 

A Boolean attribute that, if true, causes the core attributes x and y to be 
ignored and forces the default widget position. The default widget position 
is centered in the parent window. If false, the specified x and y attributes 
are used to position the widget. This argument sets the default_position 
attribute described in the low-level routine DIALOG BOX CREATE. 


X 

The placement, in pixels, of the left side of the widget window relative to 
the inner upper left corner of the parent window. This argument sets the 
core widget x attribute described in Section 8.2. 


The placement, in pixels, of the top of the widget window relative to the 
inner upper left corner of the parent window. This argument sets the core 
widget y attribute described in Section 8.2. 


style 
The style of the widget. The predefined values for this attribute are as 
follows: 


High-Level Widget Routines 
CAUTION BOX 


VAX Cc Description 


DWT$C_MODAL DwtModal Modal type box 
DWT$C_MODELESS DwiModeless Modeless type box 
This argument sets the style attribute described in the low-level routine 
DIALOG BOX POPUP CREATE. 

label 


The text in the message line or lines, This argument sets the label 
attribute described in the low-level routine CAUTION BOX CREATE. 


yes label 
The label for the Yes push button. This argument sets the yes_label 
attribute described in the low-level routine CAUTION BOX CREATE. 


no_label 
The label for the No push button. This argument sets the no_label 
attribute described in the low-level routine CAUTION BOX CREATE. 


cancel_label 

The label for the Cancel push button. This argument sets the 

cancel _label attribute described in the low-level routine CAUTION BOX 
CREATE. 


default_push_button 
The push button representing the default user action. The predefined 
values for this attribute are as follows: 


VAX Cc Description 
DWT$C_YES_ BUTTON DwtYesBuiton Yes button 
DWT$C_NO_BUTTON DwtNoButton No button 
DWT$C_CANCEL_BUTTON DwtCancelButton Cancel button 


This argument sets the default_push_button attribute described in the 
low-level routine CAUTION BOX CREATE. 


callback 

The callback routine or routines called when the Yes, No, or Cancel 
buttons have been activated. This argument sets the yes_callback, 
no_callback, and cancel_callback attributes described in the low-level 
routine CAUTION BOX CREATE. 


help_callback 


The callback routine or routines called on a help request. 





DESCRIPTION _ See the low-level routine CAUTION BOX CREATE. 
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High-Level Widget Routines 
COMMAND APPEND 


COMMAND APPEND 


Appends the passed string to the current command line. 





VAX FORMAT void = DWT$COMMAND_APPEND 
(widget, command) 


argument 

information Argument Usage Data Type Access Mechanism 
widget widget uns longword read reference 
command char string char string read descriptor 





MITC FORMAT void = DwtCommandAppend 
(widget, command) 


argument | 

information void DwtCommandAppend (widget, command) 
Widget widget; 
char *command; 





ARGUMENTS '~_ widget 
The identifier of the created widget. 


command 
The text to be appended to the command line. Lines in a multiline string 
should be separated by a line-feed character. 





DESCRIPTION _ Within the command window widget, this routine appends the passed 
string to the current command line. After the line or lines have been 
appended, all but the last line is executed and scrolled into the history 
region. If the last line sent is terminated with a line-feed character, then 
it too is executed, the command is moved to the command history, and a 
new prompt is issued. The application-supplied command entered callback 
is called once for each line executed in a multiline string. 
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High-Level Widget Routines 
COMMAND ERROR MESSAGE 


COMMAND ERROR MESSAGE 


Writes an error message in the command window. 





VAX FORMAT  void=DWT$COMMAND_ERROR_MESSAGE 
(widget, error) 


argument 


information Argument Usage —-~Data Type = Access_—~=—Ss Mechanism 


widget widget uns longword read reference 
error char string char string read descriptor 





MIT C FORMAT void = DwtCommandErrorMessage 
(widget, error) 


argument 

information void DwtCommandErrorMessage (widget, error) 
Widget widget; 
char *error; 





ARGUMENTS _ widget 


The identifier of the command window widget. 


error 

Specifies the error message to be placed in the last history line in the 
command window widget. Lines in a multiline error message should be 
separated by a line-feed character. 





DESCRIPTION Within the command window widget, this routine writes an error message 
in the history area. The history is scrolled up as necessary to provide room 
for the error message line or lines. For recall purposes, error message 
lines do not become part of the command history. 


High-Level Widget Routines 
COMMAND SET 


COMMAND SET 


Replaces the current command string with the one passed. 





VAX FORMAT void = DWT$COMMAND SET (widget, command) 


argument 

information Argument Usage Data Type Access Mechanism 
widget widget uns longword read reference 
command char string char string read descriptor 





MITC FORMAT void=DwtCommandSet (widget, command) 


argument 

information void DwtCommandSet (widget, command) 
Widget widget; 
char *command; 





ARGUMENTS _ widget 


The identifier of the created widget. 
command 


Specifies the text to replace the text currently on the command line. Lines 
in multiline commands should be separated by a line-feed character. 





DESCRIPTION Within the command window widget, this routine replaces the current 
command string with the passed string. A zero-length string can be used 
to clear the current command line. All but the last line of a multiline 
command string are executed and scrolled into the history region. If the 
last line of the command string is terminated by a line-feed character, then 
it too is executed, the command is moved to the command history, and a 
new prompt is issued. The application-supplied command entered callback 
is called once for each line executed in a multiline command string. 
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High-Level Widget Routines 
COMMAND WINDOW 


COMMAND WINDOW 


Creates a command window widget. 





VAX FORMAT ~~ widget = DWT$COMMAND_WINDOW 
(parent_widget, name, prompt, lines, callback, 
help_callback) 


argument 

information Argument Usage Data Type Access Mechanism 
widget widget uns longword write value 
parent_widget widget uns longword read reference 
name char string char string read descriptor 
prompt comp string uns longword read reference 
lines longword longword read reference 
callback callback uns longword read reference 
heip_cailback — callback uns longword read reference 





MIT C FORMAT widget = DwtCommandWindow 
(parent_widget, name, prompt, lines, callback, 
help_callback) 





argument 
information Widget DwtCommandWindow(parent_widget, name, prompt, lines, 
callback, help callback) 
Widget parent_widget; 
char *name; 
DwtCompString prompt; 
int lines; 
DwtCallbackPtr callback; 
DwtCallbackPtr help callback; 
RETURNS widget 


The identifier of the created widget. 





ARGUMENTS _ parent_widget 
The identifier of the parent widget. 


name 
The name of the created widget. 
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High-Level Widget Routines 
COMMAND WINDOW 


pr ompt 
The command line prompt. This argument sets the prompt attribute 
described in the low-level routine COMMAND WINDOW CREATE. 


lines 

The number of command history lines visible in the command widget 
window. This argument sets the lines attribute described in the low-level 
routine COMMAND WINDOW CREATE. 


callback 


The callback routine or routines called when a command is entered 
or when the contents of a command line change. This argument sets 
the command_entered_callback and the value_changed_callback 
attributes described in the low-level routine COMMAND WINDOW 
CREATE. 


help_callback 


The callback routine or routines called on a help request. 





DESCRIPTION _ See the low-level routine COMMAND WINDOW CREATE. 
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High-Level Widget Routines 
DIALOG BOX 


DIALOG BOX 


Creates a dialog box widget to contain other subwidgets. 





VAX FORMAT __ widget = DWT$DIALOG_BOX 
(parent_widget, name, default_position, x, y, title, style, 
map_callback, helop_callback) 


argument 

information Argument Usage Data Type Access Mechanism 
widget widget uns longword write value 
parent_widget — widget uns longword read reference 
name char string char string read descriptor 
default_position Boolean uns longword read reference 
x position longword read reference 
y position longword read reference 
title comp string uns longword read reference 
style byte uns longword read reference 
map_callback callback uns longword read reference 
help_callback callback uns longword read reference 





MIT C FORMAT widget = DwtDialogBox 
(parent_widget, name, default_position, x, y, title, style, 
map_callback, help_callback) 


argument 

information Widget DwtDialogBox(parent_widget, name, default_position, 
x, y, title, style, map_callback, 
help callback) 


Widget parent_widget; 
char *xname; 

Boolean default_position; 
Position x 

Position ve 


DwtCompString title; 
unsigned char style; 
DwtCallbackPtr map _callback; 
DwtCallbackPtr help callback; 
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High-Level Widget Routines 
DIALOG BOX 








RETURNS widget 
The identifier of the created widget. 
ARGUMENTS _ parent_widget 


The identifier of the parent widget. 
name 


The name of the created widget. 


default_position 

A Boolean attribute that, if true, causes the core attributes x and y to be 
ignored and forces the default widget position. The default widget position 
is centered in the parent window. If false, the specified x and y attributes 
are used to position the widget. This argument sets the default_position 
attribute described in the low-level routine DIALOG BOX CREATE. 


xX 

The placement, in pixels, of the left side of the widget window relative to 
the inner upper left corner of the parent window. This argument sets the 
core widget x attribute described in Section 8.2. 


The placement, in pixels, of the top of the widget window relative to the 
inner upper left corner of the parent window. This argument sets the core 
widget y attribute described in Section 8.2. 


title 

The text label. The text label is given to the window manager for the 
title bar if the style attribute is modeless. This argument sets the 
title attribute described in the low-level routine DIALOG BOX POPUP 
CREATE. 


style 

The style of the dialog box. There are three possible dialog styles: Modal 
and Modeless for pop-up attached dialog boxes and Workarea for regular 
attached dialog boxes. The predefined values for this attribute are as 
follows: 


VAX Cc Description 
DWT$C_MODAL | DwiModal Modal 
DWT$C_MODELESS DwtModeless Modeless 
DWT$C_WORKAREA DwtWorkarea Work area 


This argument sets the style attribute described in the low-level routines 
DIALOG BOX CREATE and DIALOG BOX POPUP CREATE. 


map_callback 


The callback routine or routines called when the dialog box is mapped. 


help_callback 


The callback routine or routines called on a help request. 
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DIALOG BOX 





DESCRIPTION See the low-level routine DIALOG BOX CREATE. 
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High-Level Widget Routines 
FILE SELECTION 


Creates a file selection box widget for the application to query the user for a 


file selection. 





VAX FORMAT 


argument 


information 


widget = DWT$FILE_SELECTION 
(parent_widget, name, x, y, title, value, dirmask, 
visible_item_count, format, default_position, callback, 
help_callback) 


Argument 


widget 


parent_widget 


name 
X 

y 

title 
value 
dirmask 


visible_item_count 


format 


default_position 


callback 
help_callback 


Usage 


widget 
widget 
char string 
position 
position 
comp string 
comp string 
comp string 
longword 
longword 
Boolean 
callback 
callback 


Data Type 


uns longword 
uns longword 
char string 
longword 
longword 

uns longword 
uns longword 
uns longword 
longword 
longword 

uns longword 
uns longword 
uns longword 


Access Mechanism 


write 
read 
read 
read 
read 
read 
read 
read 
read 
read 
read 
read 
read 


~ value 


reference 
descriptor 
reference 
reference 
reference 
reference 
reference 
reference 
reference 
reference 
reference 
reference 





MIT C FORMAT widget = DwtFileSelection 


(parent_widget, name, x, y, title, value, dirmask, 
visible_item_count, format, default_position, callback, 
help_callback) 
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FILE SELECTION 








argument 
information Widget DwtFileSelection(parent_widget, name, x, y, title, 
value, dirmask, visible item_count, 
format, default_position, callback, 
help callback) 
Widget parent_widget; 
char *name; 
Position > a 
Position Vi 
DwtCompString title; 
DwtCompString value; 
DwtCompString dirmask; 
int visible item_count; 
ant format; 
Boolean default_position; 
DwtCallbackPtr callback; 
DwtCallbackPtr help callback; 
RETURNS widget 
The identifier of the created widget. 
ARGUMENTS _ parent_widget 


The identifier of the parent widget. 


name 


The name of the created widget. 


X 


The placement, in pixels, of the left side of the widget window relative to 
the inner upper left corner of the parent window. This argument sets the 
core widget x attribute described in Section 8.2. 


The placement, in pixels, of the top of the widget window relative to the 
inner upper left corner of the parent window. This argument sets the core 
widget y attribute described in Section 8.2. 


title 


The text that appears in the banner of the file selection box. This 
argument sets the title attribute described in the low-level routine 
DIALOG BOX POPUP CREATE. 


value 


The selected file. The file name appears in the text entry field and is 
highlighted in the list box, if present. This argument sets the value 
attribute described in the low-level routine SELECTION CREATE. 


dirmask — 


The directory mask used in determining the files displayed in the file 
selection list box. This argument sets the dirmask attribute described in 
the low-level routine FILE SELECTION CREATE. 
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visible_item_count 

The maximum number of files visible at one time in the file selection list 
box. This argument sets the visible_items_count attribute described in 
the low-level routine SELECTION CREATE. 


format 
The style of the pop-up dialog box widget. The predefined values for this 
attribute are as follows: 


VAX Cc Description 
DWT$C_MODAL DwtModal Modal 
DWT$C_MODELESS DwtModeless Modeless 


This sets the style attribute described in the low-level routine DIALOG 
BOX POPUP CREATE. 


default_position 

A Boolean attribute that, if true, causes the core attributes x and y to be 
ignored and forces the default widget position. The default widget position 
is centered in the parent window. If false, the specified x and y attributes 


are used to position the widget. This argument sets the default_position 
attribute described in the low-level routine DIALOG BOX CREATE. 


callback 

The callback routine or routines called when a selection is activated, 
canceled, or when there is no match for a selected item. This argument 
sets the activate_callback, cancel_callback, and no_match_callback 
attributes described in the low-level routine SELECTION CREATE. 


help_callback 


The callback routine or routines called on a help request. 





DESCRIPTION _ See the low-level routine FILE SELECTION CREATE. 
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FILE SELECTION DO SEARCH 


Initiates a search with a directory mask option. Otherwise, the current 
directory mask is used. 





VAX FORMAT = void = DWT$FILE_SELECTION_DO_ SEARCH 
(widget, dirmask) 


argument 

information © Argument Usage Data Type Access Mechanism 
widget widget uns longword __ write value 
dirmask comp string uns longword read reference 





MIT C FORMAT §svoid = DwtFileSelectionDoSearch 


(widget, dirmask) 
argument 
information void DwtFileSelectionDoSearch (widget, dirmask) 
FileSelectionWidget widget; 
DwtCompString dirmask; 





ARGUMENTS ~_ widget 


The pointer to the file selection widget data structure. 


dirmask 

The directory mask for displaying files. If you do not specify a directory 
mask, the default directory mask is used. This argument sets the 
dirmask attribute described in the low-level routine FILE SELECTION 
CREATE. 





DESCRIPTION The file selection widget initiates file searches when any of the following 


occur: ; 
¢ The file selection widget becomes visible (managed). 


¢ The intrinsic routine SET VALUES is used to change the directory 
mask. 


e The user activates the Apply push button. 
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The application calls FILE SELECTION DO SEARCH. Using FILE 
SELECTION DO SEARCH is another means for applications to 
initiate a directory search. For example, when the application creates 
a new file and needs to reflect this change in a mapped file search 
widget, this routine could be called. 
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HELP 
HELP 
Creates a help widget. 
VAX FORMAT _ widget = DWT$HELP 
(parent_widget, name, default_position, x, y, 
application_name, library_type, library_spec, 
first_topic, overview_topic, glossary_topic, 
unmap_callback) 
argument 
information Argument Usage Data Type Access Mechanism 
widget widget uns longword write value 
parent_widget widget uns longword read reference 
name char string char string read descriptor 
default_position Boolean uns longword read reference 
Xx position longword read reference 
y position longword read reference 
application_name comp string uns longword read reference 
library_type longword longword read reference 
library_spec comp string uns longword read reference 
first_topic comp string uns longword read reference 
overview_topic comp string uns longword read reference 
glossary_topic comp string uns longword read reference 
unmap_callback callback uns longword read reference 





MIT C FORMAT widget = DwtHelp 
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(parent_widget, name, default_position, x, y, 


application_name, library_type, library_spec, 


first_topic, overview_topic, glossary_topic, 


unmap_callback) 
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HELP 








argument 
information Widget DwtHelp(parent_widget, name, default_position, x, y, 
application_name, library_type, library spec, 
first_topic, overview_topic, glossary topic, 
unmap_callback) 
Widget parent widget; 
DwtCompString name; 
Boolean default_position; 
Position x; 
Position Ve 
DwtCompString application_name; 
unsigned int library type; 
DwtCompString library spec; 
DwtCompString first topic; 
DwtCompString overview _topic; 
DwtCompString glossary topic; 
DwtCallbackPtr unmap_callback; 
RETURNS widget 
The identifier of the created widget. 
ARGUMENTS _ parent_widget 


The identifier of the parent widget. 


name 
The name of the created widget. 


default_position 

A Boolean attribute that, if true, causes the core attributes x and y to be 
ignored and forces the default widget position. The default widget position 
is centered in the parent window. If false, the specified x and y attributes 
are used to position the widget. This argument sets the default_position 
attribute described in the low-level routine DIALOG BOX CREATE. 


X 

The placement, in pixels, of the left side of the widget window relative to 
the inner upper left corner of the parent window. This argument sets the 
core widget x attribute described in Section 8.2. 


The placement, in pixels, of the top of the widget window relative to the 
inner upper left corner of the parent window. This argument sets the core 
widget y attribute described in Section 8.2. 


application_name 
The application name to be used in the widget title bar. 


library_type 


The type of help library specified by library_spec. The predefined value 
for this attribute is as follows: 
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HELP 
VMS Cc Description 
DWT$C_TEXT_ DwtTextLibrary VMS help text in a VMS Help Library or 
LIBRARY ULTRIX Help Directory 
library_spec | 
A host system file specification that identifies the help library. 
first_topic 
The first help topic to be displayed. If a null string is provided, the 
overview_topic is displayed. 
overview_topic 
The application overview topic. 
glossary_topic 
The application glossary topic. If a null string is provided, the Visit 
Glossary menu item does not appear in the widget’s View pull-down menu. 
unmap_callback 
The callback routine or routines called when the help widget is unmapped. 
DESCRIPTION See the low-level routine HELP CREATE. 
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LABEL 


Creates a label widget. 





VAX FORMAT ___ widget = DWT$LABEL 
(parent_widget, name, x, y, label, help_callback) 


argument 

information Argument Usage Data Type Access Mechanism 
widget widget uns longword write value 
parent_widget widget uns longword read reference 
name char string char string read descriptor 
X position longword read reference 
y position longword read reference 
label comp string uns longword read reference 
help_callback callback uns longword read reference 





MIT C FORMAT widget = DwtLabel 
(parent_widget, name, x, y, label, help_callback) 





argument 
information Widget DwtLabel (parent widget, name, x, y, label, 
help callback) 

Widget - parent widget; 

char *name; 

Position xX; 

Position Vi 

DwtCompString label; 

DwtCallbackPtr help callback; 
RETURNS widget 


The identifier of the created widget. 





ARGUMENTS _ parent_widget 


The identifier of the parent widget. 


name 
The name of the created widget. 
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X 

The placement, in pixels, of the left side of the widget window relative to 
the inner upper left corner of the parent window. This argument sets the 
core widget x attribute described in Section 8.2. 


The placement, in pixels, of the top of the widget window relative to the 
inner upper left corner of the parent window. This argument sets the core 
widget y attribute described in Section 8.2. 


label 


The text of the label. This argument sets the label attribute described in 
the low-level routine LABEL CREATE. 


help_callback 


The callback routine or routines called on a help request. 





DESCRIPTION 
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LIST BOX 


Creates a list box widget. 





VAX FORMAT __ widget = DWT$LIST_BOX 
(parent_widget, name, x, y, items, item_count, 
visible_item_count, callback, help_callback, resize, 





horiz) 

argument 

information Argument Usage Data Type Access Mechanism 
widget widget uns longword write value 
parent_widget widget uns longword read reference 
name char string char string read descriptor 
X position longword read reference 
y position longword read reference 
items array uns longword read reference 
item_count longword longword read reference 
visible_item_count longword longword read reference 
callback callback uns longword read reference 
help_callback callback uns longword read reference 
resize unsigned uns longword read reference 

longword 

horiz Boolean uns longword read reference 

FORMAT widget = DwtListBox 


(parent_widget, name, x, y, items, item_count, 
visible_item_count, callback, help_callback, resize, 
horiz) 
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argument 
i H Widget DwtListBox(parent widget, name, x, y, items, item_count, 
information visible item_count, callback, help callback, 
resize, horiz) 
Widget parent widget; 
char *Aname; 
Position x; 
Position yi 
DwtCompString *items; 
int item count; 
int visible _items_count; 
DwtCallbackPtr callback; 
DwtCallbackPtr help callback; 
unsigned char resize; 
Boolean horiz; 
RETURNS widget 
The identifier of the created widget. 
ARGUMENTS __ parent_widget 


The identifier of the parent widget. 


name 


The name of the created widget. 


X 


The placement, in pixels, of the left side of the widget window relative to 
the inner upper left corner of the parent window. This argument sets the 
core widget x attribute described in Section 8.2. 


The placement, in pixels, of the top of the widget window relative to the 
inner upper left corner of the parent window. This argument sets the core 
widget y attribute described in Section 8.2. 


items 


The list of items to be used by the list box widget. This argument sets the 
items attribute described in the low-level routine LIST BOX CREATE. 


item_count 


The total number of items in the list. This argument sets the item_count 
attribute described in the low-level routine LIST BOX CREATE. 


visible_items_count 

The maximum number of visible items contained in the list box. For 
example, if item_count is 20, but visible_items_count is 5, only 5 items 
are visible at any one time. This argument sets the visible_items_count 
attribute described in the low-level routine LIST BOX CREATE. 


callback 


A callback routine or routines called when the single callback, single 
confirm callback, extend callback, and extend confirm callback functions 
are activated. This argument sets the single_callback, 


High-Level Widget Routines 
LIST BOX 


single_confirm_callback, extend_callback, and extend_confirm_ 
callback attributes described in the low-level routine LIST BOX CREATE. 


help_callback 


The callback routine or routines called on a help request. 


resize 
VAX binding: DWT$C_NRESIZE 
C binding: DwtNresize 


How the list box resizes when its children are managed and unmanaged 
and on geometry requests. The predefined values for this attribute are as 


follows: 

VAX Cc Description 

DWT$C_RESIZE_FIXED DwtResizeFixed List box does not change 
its size when items are 
added or deleted. 

DWT$C_RESIZE_GROW_ DwtResizeGrowOnly List box attempts to 

ONLY expand as necessary 


when items are added. 


If resize is set to Fixed, DIGITAL suggests that horiz be set true. 


horiz 

A Boolean argument that specifies whether the list box contains a 
horizontal scroll bar. If true, the list box contains a horizontal scroll 

bar. If false, the list box does not contain a horizontal scroll bar. This 
argument sets the horizontal attribute described in the low-level routine 
LIST BOX CREATE. 


A horizontal scroll bar cannot be added or deleted to a list box after the 
list box is created. 





DESCRIPTION “ee the low-level routine LIST BOX CREATE. 
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LIST BOX ADD ITEM 


Adds an item to the list within a list box widget. 





VAX FORMAT = _— void = DWT$LIST_BOX_ADD_ITEM 
(widget, item, position) 


argument 

information Argument Usage Data Type Access Mechanism 
widget widget uns longword read reference 
item comp string uns longword read reference 
position longword longword read reference 





MIT C FORMAT void = DwtListBoxAddlitem 
(widget, item, position) 


argument 

information void DwtListBoxAddItem(widget, item, position) 
Widget widget; 
DwtCompString item; 
int position; 





ARGUMENTS __ widget 
The identifier of the list box widget. 


item 
The text of the item to be added. 


position 

The placement of the item within the list in terms of cell position. It 
uses an insert-mode, cell-number scheme with 1 specifying the topmost 
entry position, and 0 specifying the bottom entry for adding an item to the 
bottom of the list. 





DESCRIPTION LIST BOX ADD ITEM adds an item to the list within the list box widget. 
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LIST BOX DELETE ITEM 


Deletes an item from the list within a list box widget. 





VAX FORMAT void = DWT$LIST_BOX_DELETE_ITEM 


(widget, item) 
argument 
information Argument Usage Data Type Access Mechanism 
widget widget uns longword read reference 
item comp string uns longword read reference 





MITC FORMAT void = DwtListBoxDeleteltem 


(widget, item) 
argument 
information void DwtListBoxDeleteItem(widget, item) 
Widget widget; 


DwtCompString item; 





ARGUMENTS _ widget 
The identifier of the list box widget. 


item 
The text of the item to be deleted. 
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DESCRIPTION _ LIST BOX DELETE ITEM deletes an item from a list within the list box 
widget. The routine searches the list for the item, removes it, and moves 
any subsequent entries up one cell position throughout the remaining list. 
See the related routine LIST BOX ADD ITEM. 
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LIST BOX DELETE POS 


Deletes an item identified by its position from the list within a list box widget. 





VAX FORMAT void =DWTS$LIST_BOX_DELETE_POS 


(widget, position) 
argument 
information Argument Usage Data Type Access Mechanism 
widget widget uns longword read reference 
position longword longword read reference 





MIT C FORMAT svoid = DwtListBoxDeletePos 


(widget, position) 
argument 
information void DwtListBoxDeletePos (widget, position) 
Widget widget; 
int position; 





ARGUMENTS ~~ widget 
The identifier of the list box widget. 


position 
An integer identifying the position of the item to be deleted from the list. 
The first item in the list is in position 1. 





DESCRIPTION LIST BOX DELETE POS deletes an item from a list within the list box 
widget. The item to be deleted is identified by its position in the list. 
The routine searches the list for the specified position, removes the item 
in that position, and moves any subsequent entries up one cell position 
throughout the remaining list. 
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LIST BOX DESELECT ALL ITEMS 


Cancels the selection of all previously selected items in a list box. 





VAX FORMAT  void=DWT$LIST_BOX_DESELECT_ALL_ITEMS 
(widget ) 


argument 


Information Argument Usage ——DataType = Access.~=—S—S«wMechaanism 


widget widget uns longword read reference 





MIT C FORMAT _svoid = DwtListBoxDeselectAliltems 
(widget ) 


argument 
information void DwtListBoxDeselectAllitems (widget) 
Widget widget; 





ARGUMENTS __ widget 
The identifier of the list box widget. 





DESCRIPTION _ LIST BOX DESELECT ALL ITEMS cancels the selection of all items 
previously selected, and removes them from the list of selected items. 
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LIST BOX DESELECT ITEM 


Cancels the selection of a previously selected item in a list box. 





VAX FORMAT = void = DWT$LIST_BOX_DESELECT_ITEM 
(widget, item ) 


argument 

information Argument Usage Data Type Access Mechanism 
widget widget uns longword read reference 
item comp string uns longword read reference 





MIT C FORMAT §svoid = DwtListBoxDeselectitem 
(widget, item ) 


argument 

information void DwtListBoxDeselectItem(widget, item) 
Widget widget; 
DwtCompString item; 





ARGUMENTS _ widget 


The identifier of the list box widget. 


item 
The item in the list box to be deselected. 





DESCRIPTION LIST BOX DESELECT ITEM cancels the selection of an item and removes 
it from the list of selected items. 
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LIST BOX DESELECT POS 


Cancels the selection of an item identified by its position in a list box. 





VAX FORMAT _ void =DWT$LIST_BOX_DESELECT_POS 


(widget, position ) 
argument 
information Argument Usage Data Type Access Mechanism 
widget widget uns longword read reference 
position uns longword uns longword ___ read reference 





MIT C FORMAT svoid = DwtListBoxDeselectPos 


(widget, position ) 
argument 
information void DwtListBoxDeselectPos (widget, position) 
Widget . widget; 
int position; 





ARGUMENTS ~_ widget 
The identifier of the list box widget. 


position 
An integer identifying the position of the item to be deselected. The first 
item in the list box is in position 1. 





DESCRIPTION LIST BOX DESELECT POS cancels the selection of an item based on its 
position in a list box and removes the item from the list of selected items. 
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LIST BOX ITEM EXISTS 


Verifies the existence of a particular item in a list box. 





VAX FORMAT ~_ Boolean = DWT$LIST_BOX_ITEM_EXISTS 
(widget, item ) 


argument 


information Argument Usage —=—Data Type = Access. ~=—s Mechanism _ 


widget widget uns longword read reference 
item comp string uns longword read reference 





MITC FORMAT Boolean = DwtListBoxltemExists 
(widget, item ) 





argument 
information Boolean DwtListBoxItemExists (widget, item) 
Widget widget; 
- DwtCompString item; 
RETURNS Boolean 


If true, a specified item exists in the list box. 





ARGUMENTS ~~ widget 
The identifier of the list box widget. 


item 
The item being searched for in the list box. 





DESCRIPTION _ LIST BOX ITEM EXISTS searches a list box to determine if an item 
exists. , 
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LIST BOX SELECT ITEM 


Selects an item in the list box. 





VAX FORMAT void = DWT$LIST_BOX_SELECT_ITEM 
(widget, item, notify ) 


argument 

information Argument Usage Data Type Access Mechanism 
widget widget uns longword read reference 
item comp string uns longword read reference 
notify Boolean uns longword read reference 





MIT C-STYLE void =DwtListBoxSelectltem 


FORMAT (widget, item, notify ) 

argument 

information void DwtListBoxSelectitem(widget, item, notify) 
Widget widget; 
DwtCompString item; 
Boolean notify; 





ARGUMENTS _ widget 


The identifer of the list box widget. 


item 
The item to be added to the list box. 
notify 


If true, using this routine results in a callback to the application in the 
same way that a user selection results in a callback. 


DESCRIPTION _ LIST BOX SELECT ITEM selects an item in a list box, adds it to a 
selected items list, and calls back to the application, if notify is true. 
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LIST BOX SELECT POS 


Selects an item identified by its position in the list box. 





VAX FORMAT void = DWT$LIST_BOX_SELECT_POS 
(widget, position, notify ) 


argument 

information Argument Usage Data Type Access Mechanism 
widget widget uns longword _read reference 
position uns longword uns longword read reference 
notify Boolean uns longword read reference 





MIT C-STYLE void = DwtListBoxSelectPos 


FORMAT (widget, position, notify ) 

argument 

information void DwtListBoxSelectPos (widget, position, notify) 
Widget widget; 
int position; 


Boolean notify; 





ARGUMENTS __ widget 


The identifer of the list box widget. 


position 
An integer identifying the position of the item to be selected. The first 
item in the list box is in position 1. 


notify 
If true, using this routine results in a callback to the application in the 
same way that a user selection results in a callback. 


DESCRIPTION _ LIST BOX SELECT POS selects an item in a list box based on its position 
in the list, adds it to the list of selected items, and calls back to the 
application, if notify is true. 
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LIST BOX SET HORIZ POS 


Sets the horizontal scroll bar slider to a specified position. 





VAX FORMAT _ void = DWTS$LIST_BOX_SET_HORIZ_POS 


(widget, position) 
argument 
information Argument Usage Data Type Access Mechanism 
widget widget uns longword read reference 
position uns longword uns longword read reference 





MIT C FORMAT void = DwtListBoxSetHorizPos 


(widget, position ) 
argument 
‘information void DwtListBoxSetHorizPos (widget, position) 
Widget widget; 
int position; 





ARGUMENTS __ widget 
The identifier of the list box widget. 


position 
The position in pixels of the horizontal scroll bar slider in the list box. 


DESCRIPTION _ LIST BOX SET HORIZ POS is used only if the list box has a horizontal 
scroll bar and the list box contains items too wide to be visible within 
the current list box width. For example, this routine is used by the file 
selection widget. 
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LIST BOX SET ITEM 


Makes a specified item (if it exists) the first visible item in a list box, or as 
close to the top as possible. The item always becomes visible. 





VAX FORMAT void =DWT$LIST_BOX_SET_ITEM (widget, item) 


argument 


information Argument Usage —Data Type = Access_=—S—S—s« Mechanism 


widget widget uns longword read reference 
item comp string uns longword read reference 





MIT C FORMAT void =DwiListBoxSetltem (widget, item ) 


argument 

information void DwtListBoxSetItem(widget, item) 
Widget widget; 
DwtCompString item; 





ARGUMENTS _ widget 
The identifier of the list box widget. 


item 
The item to be made the first item in the list box. 





DESCRIPTION _ LIST BOX SET ITEM makes an item in the list box the first visible item. 


This routine determines which item in the list box displays at the top of 
the list box. The choice of which item displays is limited by the 
item_count and visible_item_count arguments to the list box widget. 


When visible_item_count is greater than 1 and less than item_count, 
the list box widget fills the list box with the maximum visible items 
regardless of the position of the item. For example, if item_count is 10 
and visible_item_count is 5, you cannot make item 8 display at the top 
of the list box. Items 6 through 10 would display. Setting item to the 
fourth item in the list would make items 4 through 8 display. If 
visible_item_count is 1, you can make any item in the list display at the 
top of the list box. 
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LIST 8OX SET POS 


Makes a specified position (item number in list) the top visible position in a list 
box, or as close to the top as possible. 





VAX FORMAT ~~ void = DWT$LIST_BOX_SET_POS 


(widget, position ) 
argument 
information Argument Usage Data Type Access Mechanism 
widget widget uns longword read reference 
position uns longword —_ uns longword read reference 





MIT C FORMAT void = DwtListBoxSetPos 


(widget, position ) 
argument 
information void DwtListBoxSetPos (widget, position) 
Widget widget; 
int position; 





ARGUMENTS __ widget 
The identifier of the list box widget. 


position 
The item number in the list displayed in the top position in the list box. 





DESCRIPTION _ LIST BOX SET POS determines which item in the list box displays at 
the top of the list box. The choice of which item displays is limited by the 
item_count and visible_item_count arguments to the list box widget. 


When visible_item_count is greater than 1 and less than item_count, 
the list box widget fills the list box with the maximum visible items 
regardless of the position value. For example, if item_count is 10 and 
visible_item_count is 5, you cannot make item 8 display at the top of the 
list box. Items 6 through 10 would display. Setting position to 4 would 
make items 4 through 8 display. If visible_item_count is 1, you can 
make any item in the list display at the top of the list box. 
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MAIN WINDOW 


Creates the main window widget. 





VAX FORMAT _ widget = DWT$MAIN_WINDOW 
(parent_widget, name, x, y, width, height) 


argument 

information Argument Usage Data Type Access Mechanism _ 
widget widget uns longword write value 
parent_widget widget uns longword read reference 
name char string char string read descriptor 
Xx position longword read reference 
y position longword read reference 
width dimension uns longword read reference 
height dimension uns longword read reference 





MIT C FORMAT widget = DwtMainWindow 
(parent_widget, name, x, y, width, height) 





argument 
information Widget DwtMainWindow (parent _widget, name, X, Y, 
width, height) 
Widget parent widget; 
char *name; 
Position xs 
Position ye 
Dimension width; 
Dimension height; 
RETURNS widget 


The identifier of the created widget. 





ARGUMENTS __ parent_widget 
The identifier of the parent widget. 


name 
The name of the list box widget. 
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X 

The placement, in pixels, of the left side of the widget window relative to 
the inner upper left corner of the parent window. This argument sets the 
core widget x attribute described in Section 8.2. 


The placement, in pixels, of the top of the widget window relative to the 
inner upper left corner of the parent window. This argument sets the core 
widget y attribute described in Section 8.2. 


width 


The width of the widget window in pixels. This argument sets the core 
widget width attribute described in Section 8.2. 


height 
The height of the widget window in pixels. This argument sets the core 
widget height attribute described in Section 8.2. 





DESCRIPTION See the low-level routine MAIN WINDOW CREATE. 
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MAIN WINDOW SET AREAS 


Sets up or adds the menu bar, work window, command window, and scroll bar 
widgets to the main window widget of the application. 





VAX FORMAT void = DWT$MAIN_SET_AREAS 
(widget, menu bar, work_window, command_window, 
h_scroll, v_scroll) 


argument 

information Argument Usage Data Type Access Mechanism 
widget widget uns longword read reference 
menu bar identifier uns longword read reference 
work_window identifier uns longword read reference 
command_window identifier uns longword read reference 
h_scroll identifier uns longword read reference 
v_scroll identifier uns longword read reference 





MIT C FORMAT §svoid = DwtMainSetAreas 
(widget, menu bar, work_window, command_window, 
h_scroll, v_scroll) 


argument 
information void DwtMainSetAreas (widget, menu bar, work_window, 
command_window, h_scroll, v_scroll) 
Widget widget; 
Widget menu bar; 
Widget work_window; 
Widget command_window; 
Widget h_scroll; 
Widget v_scroll; 





ARGUMENTS _ widget 


The identifier of the main window widget. 


menu_bar 
The identifier of the menu bar widget. 


work_window | 
The identifier of the work window widget. 
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command_window 


The identifier of the command window widget 


h_scroll 
The identifier of the horizontal scroll bar widget. 


v_scroll 
The identifier of the vertical scroll bar widget. 





DESCRIPTION 


MAIN WINDOW SET AREAS sets up or adds the menu bar, work window, 
command window, and scroll bar widgets to the main window widget for 
the application. Each area is optional and may be passed as null. The title 
bar is provided by the window manager. 


See the Geometry Management section of MAIN WINDOW CREATE for 
more detail on setting the areas of a main window widget. 
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MENU 


Creates a menu widget to contain menu items. 





VAX FORMAT 


argument 
information 


widget = DWT$MENU 
(parent_widget, name, x, y, format, orientation, 
entry_callback, map_callback, help_callback) 


Argument Usage 
widget widget 
parent_widget widget 
name char string 
X position 

y position 
format identifier 
orientation uns byte 


entry_callback callback 
map_callback — callback 
help_caliback — callback 


Data Type Access Mechanism 
uns longword write value 

uns longword read reference 
char string read descriptor 
longword read reference 
longword read reference 
uns longword read reference 
uns longword read reference 
uns longword read reference 
uns longword read reference 
uns longword read reference 





MIT C FORMAT widget = DwtMenu 


argument 
information 
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(parent_widget, name, x, y, format, orientation, 
entry_callback, map_callback, help_callback) 


Widget DwtMenu(parent_widget, name, x, y, format, orientation, 
entry callback, map_callback, help_callback) 


Widget 

char 

Position 
Position 

int 

unsigned char 
DwtCallbackPtr 
DwtCallbackPtr 
DwtCallbackPtr 


parent_widget; 
*name; 

x; 

yr 

format; 
orientation; 
entry callback; 
map callback; 
help callback; 


High-Level Widget Routines 
MENU 








RETURNS widget 
The identifier of the created widget. 
ARGUMENTS _ parent_widget 


The identifier of the parent widget. 


name 
The name of the list box widget. 


xX 

The placement, in pixels, of the left side of the widget window relative to 
the inner upper left corner of the parent window. This argument sets the 
core widget x attribute described in Section 8.2. 


The placement, in pixels, of the top of the widget window relative to the 
inner upper left corner of the parent window. This argument sets the core 
widget y attribute described in Section 8.2. 


format 
The type of menu widget. The predefined values for this argument are as 
follows: 


VAX Cc Description 


DWT$C_MENU_POPUP DwtMenuPopup Pop-up menu 
DWT$C_MENU_PULL_DOWN DwtMenuPullDown Pull-down menu 
DWT$C_MENU_WORK_AREA DwtMenuWorkArea Work area menu 


orientation 
The orientation of the menu. The predefined values for this attribute are 
as follows: 


VAX Cc Description 
DWT$C_ORIENTATION__ DwtOrientationHorizontal Horizontal menu 
HORIZONTAL 

DWT$C_ORIENTATION_ DwtOrientationVertical Vertical menu 
VERTICAL 


This argument sets the orientation attribute described in the low-level 
routine MENU CREATE. 


entry_callback 

The callback routine that causes all menu entry activation callbacks to 
be revectored to call back through this callback. This argument sets 
the entry_callback attribute described in the low-level routine MENU 
CREATE. 


map_callback 
A widget-specific callback routine that enables the application to request a 
callback because the window is about to: be mapped. 
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help_callback 


The callback routine or routines called on a help request. 





DESCRIPTION See the low-level routine MENU CREATE. 
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MENU BAR 


Creates a menu bar widget to contain menus. 





VAX FORMAT ~~ _ widget = DWT$MENU_BAR 
(parent_widget, name, entry_callback, help_callback) 


argument 

information Argument Usage Data Type Access Mechanism 
widget widget uns longword write value 
parent_widget widget uns longword read reference 
name char string char string read descriptor 
entry_cailback callback uns longword read reference 
help_callback — callback uns longword read reference 





MIT C FORMAT widget = DwtMenuBar 
(oarent_widget, name, entry_callback, help_callback) 


argument 





information Widget DwtMenuBar(parent_widget, name, entry callback, 
help_ callback) 
Widget parent_widget; 
char *name; 
DwtCallbackPtr entry callback; 
DwtCallbackPtr help callback; 
RETURNS widget 


The identifier of the created widget. 





ARGUMENTS _ parent_widget 


The identifier of the parent widget. 


name 
The name of the created widget. 


entry_callback 

The callback routine that causes all menu entry activation callbacks to 
be revectored to call back through this callback. This argument sets 
the entry_callback attribute described in the low-level routine MENU 
CREATE. 
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help_callback 


The callback routine or routines called on a help request. 





DESCRIPTION _ See the low-level routine MENU BAR CREATE. 
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MENU POSITION 


Positions the pop-up menu when user presses MB2. 





VAX FORMAT void = DWT$MENU POSITION (widget, event) 


argument 


information Argument Usage —~Data Type = Access. ~=—s Mechanism 


widget widget uns longword read reference 
event event uns longword read reference 





MIT C FORMAT void=DwtMenuPosition (widget, event) 


argument 
information void DwtMenuPosition 
; Widget widget; 
XEvent *event; 





ARGUMENTS _ widget 


The pop-up menu widget to be positioned. 


event 
The event passed to the action procedure, which manages the pop-up 
menu. 





DESCRIPTION Positions the pop-up menu when the user presses MB2. This routine must 
be called before managing the pop-up menu. 
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MESSAGE BOX 


Creates a message box widget. 





VAX FORMAT _ widget = DWT$MESSAGE_BOX 
(parent_widget, name, default_position, x, y, style, 
label, ok_label, callback, help_callback) 


argument 

information Argument Usage Data Type Access Mechanism 
widget widget uns longword write value 
parent_widget widget uns longword read reference 
name char string char string read descriptor 
default_position Boolean uns longword read reference 
X position longword read reference 
y position longword read reference 
style uns longword uns longword read reference 
label comp string uns longword read reference 
ok_label comp string uns longword read reference 
callback callback uns longword read reference 
help_callback callback uns longword read reference 





MITC FORMAT widget = DwtMessageBox 
(parent_widget, name, default_position, x, y, style, 
label, ok_label, callback, help_callback) 


argument 
j i Widget DwtMessageBox(parent_widget, name, default_position, 
information Xx, y, style, label, ok_label, callback, 
help callback) 

Widget parent widget; 

char *name; 

Boolean default_position; 

Position x; 

Position yi 


unsigned char style; 
DwtCompString label; 
DwtCompString ok_label; 
DwtCallbackPtr callback; 
DwtCallbackPtr help callback; 
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RETURNS widget 
The identifier of the created widget. 
ARGUMENTS _ parent_widget 


The identifier of the parent widget. 
name 


The name of the created widget. 


default_position 

A Boolean attribute that, if true, causes the core attributes x and y to be 
ignored and forces the default widget position. The default widget position 
is centered in the parent window. If false, the specified x and y attributes 
are used to position the widget. This argument sets the default_position 
attribute described in the low-level routine DIALOG BOX CREATE. 


X 

The placement, in pixels, of the left side of the widget window relative to 
the inner upper left corner of the parent window. This argument sets the 
core widget x attribute described in Section 8.2. 


The placement, in pixels, of the top of the widget window relative to the 
inner upper left corner of the parent window. This argument sets the core 
widget y attribute described in Section 8.2. 


style 
The style of the message box widget. The predefined values for this 
attribute are as follows: 


VAX Cc Description 


DWT$C_MODAL DwtModal Modal 
DWT$C_MODELESS _ DwtModeless Modeless 


This argument sets the style attribute described in the low-level routine 
DIALOG BOX POPUP CREATE. 


label 


The text in the message line or lines. This argument sets the label 
attribute described in the low-level routine MESSAGE BOX CREATE. 


ok_label 
The text of the OK push button. This argument sets the ok_label 
attribute described in the low-level routine MESSAGE BOX CREATE. 


callback 


The callback routine or routines called when the OK push button is 
activated. This argument sets the yes_callback atttribute described in 
the low-level routine MESSAGE BOX CREATE. 


help_callback 


The callback routine or routines called on a help request. 
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DESCRIPTION _ See the low-level routine MESSAGE BOX CREATE. 
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OPTION MENU 


Creates an option menu widget. 





VAX FORMAT __ widget = DWT$OPTION_MENU 
(parent_widget, name, x, y, label, entry_callback, 
help_callback) 


argument 

information Argument Usage Data Type Access Mechanism 
widget widget uns longword write value 
parent_widget widget uns longword read reference 
name char string char string read descriptor 
Xx position longword read reference 
y position longword read reference 
label comp string uns longword read reference 
entry_callback callback uns longword read reference 


help_callback —_ callback uns longword read reference 





MIT C FORMAT widget = DwtOptionMenu 
(parent_widget, name, x, y, label, entry_callback, 
help_callback) 





argument 
H i Widget DwtOptionMenu (parent widget, name, x, y, label, 
information entry callback, help callback) 
Widget parent_widget; 
char *name; 
Position x; 
Position Vi 
DwtCompString label; 
DwtCallbackPtr entry callback; 
DwtCallbackPtr help callback; 
RETURNS widget 


The identifier of the created widget. 
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ARGUMENTS 


parent_widget 
The identifier of the parent widget. 


name 
The name of the created widget. 


X 

The placement, in pixels, of the left side of the widget window relative to 
the inner upper left corner of the parent window. This argument sets the 
core widget x attribute described in Section 8.2. 


The placement, in pixels, of the top of the widget window relative to the 
inner upper left corner of the parent window. This argument sets the core 
widget y attribute described in Section 8.2. 


label 


The text in the menu label. This argument sets the label attribute 
described in the low-level routine MENU CREATE. 


entry_callback 

The callback routine that causes all menu entry activation callbacks to 
be revectored to call back through this callback. This argument sets 
the entry_callback attribute described in the low-level routine MENU 
CREATE. 


help_callback 


The callback routine or routines called on a help request. 





DESCRIPTION 
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PULL DOWN MENU ENTRY 


Creates a pull-down menu entry widget. 





VAX FORMAT _ widget = DWT$PULL_DOWN_MENU_ENTRY 
(parent_widget, name, x, y, label, menu_id, callback, 
help_callback) 


argument 

information Argument Usage Data Type Access Mechanism 
widget widget uns longword write value 
parent_widget widget uns longword read reference 
name char string char string read descriptor 
X position longword read reference 
y position longword read reference 
label comp string uns longword read reference 
menu_id indentifier uns longword read reference 
callback callback uns longword read reference 
help_callback — callback uns longword read reference 





MIT C FORMAT widget = DwtPullDownMenuEntry 
(parent_widget, name, x, y, label, menu_id, callback, 
help_callback) 





argument 
i H Widget DwtPullDownMenuEntry (parent _widget, name, x, y, label, 
information menu_id, callback, help_callback) 
Widget parent widget; 
char *name; 
Position xX; 
Position V3 
DwtCompString label; 
Widget menu_id; 
DwtCallbackPtr callback; 
DwtCallbackPtr help callback; 
RETURNS widget 


The identifier of the created widget. 
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ARGUMENTS _ parent_widget 
The identifier of the parent widget. 
name 
Name of the created widget. 
xX 
The placement, in pixels, of the left side of the widget window relative to 
the inner upper left corner of the parent window. This argument sets the 
core widget x attribute described in Section 8.2. 
The placement, in pixels, of the top of the widget window relative to the 
inner upper left corner of the parent window. This argument sets the core 
widget y attribute described in Section 8.2. 
label 
The text of the label in the parent menu widget. This argument sets the 
label attribute described in the low-level routine LABEL CREATE. 
menu_id 
The identifier of the pull-down menu widget. 
callback 
The callback routine or routines called when a button inside a pull-down 
menu entry widget is activated. This argument sets the 
activate_callback described in the low-level routine PULL DOWN 
MENU ENTRY CREATE. 
help_callback 
The callback routine or routines called on a help request. 
DESCRIPTION _ See the low-level routine PULL DOWN MENU ENTRY CREATE. 
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PULL DOWN MENU ENTRY HILITE 


Highlights a menu entry. 





VAX FORMAT ~— void = DWT$PULL_DOWN_MENU_ENTRY_HILITE 


(widget, hilite) 
argument 
information Argument Usage Data Type Access = Mechanism 
widget widget uns longword read reference 
hilite longword longword read reference 





MIT C FORMAT void = DwtPullDownMenuEntryhHilite 


(widget, hilite) 
argument 
information void DwtPullDownMenuEntryHilite 
Widget widget; 
int hilite; 





ARGUMENTS ~~ widget 
The pull-down menu entry widget to highlight. 


hilite 
A Boolean attribute that specifies whether a pull-down menu entry is 


highlighted. If true, the entry is highlighted. If false, the entry is not 
highlighted. 





DESCRIPTION _ This routine is used to manually control the ec of pull-down 
menu entry widgets. 
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PUSH BUTTON 


Creates a push button widget. 





VAX FORMAT _ widget = DWT$PUSH_BUTTON 
(parent_widget, name, x, y, label, callback, 
help_callback) 


argument 

information Argument Usage Data Type Access Mechanism 
widget widget uns longword write value 
parent_widget widget uns longword read reference 
name char string char string read descriptor 
X position longword read reference 
y position longword read reference 
label comp string uns longword read reference 
callback callback uns longword read reference 
help_callback — callback uns longword read reference 





MIT C FORMAT widget = DwtPushButton 
(parent_widget, name, x, y, label, callback, 
help_callback) 





argument 
information Widget DwtPushButton(parent_widget, name, x, y, label, 
callback, help callback) 
Widget parent widget; 
char *name; 
Position << 
Position Vi 
DwtCompString label; 
DwtCallbackPtr callback; 
DwtCallbackPtr help callback; 
RETURNS widget 


The identifier of the created widget. 
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ARGUMENTS 


parent_widget 
The identifier of the parent widget. 


name 
The name of the created widget. 


xX 

The placement, in pixels, of the left side of the widget window relative to 
the inner upper left corner of the parent window. This argument sets the 
core widget x attribute described in Section 8.2. 


y 


The placement, in pixels, of the top of the widget window relative to the 
inner upper left corner of the parent window. This argument sets the core 
widget y attribute described in Section 8.2. 


label 


The text of the button label. This argument sets the label attribute 
described in the low-level routine PUSH BUTTON CREATE. 


callback 


The callback routine or routines called when a push button is activated. 
This argument sets the activate_callback attribute described in the 
low-level routine PUSH BUTTON CREATE. 


help_callback 


The callback routine or routines called on a help request. 





DESCRIPTION 


See the low-level routine PUSH BUTTON CREATE. 
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RADIO BOX 


Creates a radio box widget for the application to display multiple toggle 
buttons. 





VAX FORMAT _ widget=DWT$RADIO_BOX 
(parent_widget, name, x, y, entry_callback, 
help_callback) 


argument 

information Argument Usage Data Type Access Mechanism 
widget widget uns longword write value 
parent_widget __ widget uns longword read reference 
name char string char string read descriptor 
x position longword read reference 
y position longword read reference 
entry_callback callback uns longword read reference 
help_callback callback uns longword read reference 





MIT C FORMAT widget = DwtRadioBox 
(parent_widget, name, x, y, entry_callback, 
help_callback) 





argument 
information Widget DwtRadioBox (parent_widget, name, x, y, entry callback, 
help callback) 
Widget parent widget; 
char *name; 
Position — xe 
Position Vi 
DwtCallbackPtr entry_callback; 
DwtCallbackPtr help callback; 
RETURNS widget 


The identifier of the created widget. 





ARGUMENTS _ parent_widget 
The identifier of the parent widget. 


name 
The name of the created widget. 
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X 

The placement, in pixels, of the left side of the widget window relative to 
the inner upper left corner of the parent window. This argument sets the 
core widget x attribute described in Section 8.2. 


The placement, in pixels, of the top of the widget window relative to the 
inner upper left corner of the parent window. This argument sets the core 
widget y attribute described in Section 8.2. 


entry_callback 

The callback routine that causes all menu entry activation callbacks to 
be revectored to call back through this callback. This argument sets 
the entry_callback attribute described in the low-level routine MENU 
CREATE. 


help_callback 


The callback routine or routines called on a help request. 





DESCRIPTION See the low-level routine RADIO BOX CREATE. 
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SCALE 


Creates a scale widget. 





VAX FORMAT _ _ widget = DWT$SCALE 
(parent_widget, name, x, y, width, height, scale_width, 
scale_height, title, min_value, max_value, 
decimal_points, value, orientation, callback, 
drag_callback, help_callback) 
argument 
information Argument Usage Data Type Access Mechanism 
widget widget uns longword write value 
parent_widget widget uns longword read reference 
name char string char string read descriptor 
x position longword read reference 
y position longword read reference 
width dimension uns longword read reference 
height dimension uns longword read reference 
scale_width dimension uns longword read reference 
scale_height dimension uns longword read reference 
title comp string uns longword read reference 
min_value longword longword read reference 
max_value longword longword read reference 
decimal_points. longword longword read reference 
value longword longword read reference 
orientation uns byte uns longword read reference 
callback callback uns longword read reference 
drag_callback callback uns longword read reference 
help_callback callback uns longword read reference 





MITC FORMAT widget = DwtScale 


(parent_widget, name, x, y, width, height, scale_wiadth, 
scale_height, title, min_value, max_value, 
decimal_points, value, orientation, callback, 
drag_callback, help_callback) 
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argument 
information Widget DwtScale(parent widget, name, x, y, width, 
height, scale width, scale _ height, title, 
min_value, max_value, decimal_points, value, 
orientation, callback, drag_callback, 
help_callback) 
Widget parent widget; 
char *name; 
Position ace 
Position Vi 
DwtCompString title; 
Dimension width; 
Dimension height; 
Dimension scale width; 
Dimension scale height; 
int min_value; 
int max value; 
int decimal points; 
int value; 
unsigned char orientation; 
DwtCallbackPtr callback; 
DwtCallbackPtr drag_callback; 
DwtCallbackPtr help callback; 
RETURNS widget 
The identifier of the created widget. 
ARGUMENTS _ parent_widget 


The identifier of the parent widget. 
name 


The name of the created widget. 


xX 

The placement, in pixels, of the left side of the widget window relative to 
the inner upper left corner of the parent window. This argument sets the 
core widget x attribute described in Section 8.2. 


The placement, in pixels, of the top of the widget window relative to the 
inner upper left corner of the parent window. This argument sets the core 
widget y attribute described in Section 8.2. 


width 

The width of the scale widget. The scale widget width is calculated based 
on the scale width, the label widths, and orientation. This argument sets 
the core widget width attribute described in Section 8.2. 


height 

The height of the scale widget. The scale widget height is calculated based 
on the scale height, the labels, and orientation. This argument sets the 
core widget height attribute described in Section 8.2. 
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scale_width 
The width of the scale (excluding the scale labels). This argument sets the 
scale_width attribute described in the low-level routine SCALE CREATE. 


scale_height 

The height of the scale (excluding the scale labels). This argument sets 
the scale_height attribute described in the low-level routine SCALE 
CREATE. 


title 


The text string to appear in the scale window widget. 


min_value 
The minimum value of the scale (at the bottom or left end position). This 


argument sets the min_value attribute described in the low-level routine 
SCALE CREATE, . 


max_value 
The maximum value of the scale (at the top or right end position), This 


argument sets the max_value attribute described in the low-level routine 
SCALE CREATE. 


decimal_points 

The number of decimal points to shift the current slider value for display 
of the next slider position. This argument sets the decimal_points 
attribute described in the low-level routine SCALE CREATE. 


value 
The value represented by the slider’s current position. This argument sets 
the value attribute described in the low-level routine SCALE CREATE. 


orientation 
The orientation of the scale. The predefined values for this attribute are 
as follows: 


VAX Cc Description 
DWT$C_ORIENTATION__ DwtOrientationHorizontal Horizontal scale 
HORIZONTAL 

DWT$C_ORIENTATION_VERTICAL DwtOrientationVertical Vertical scale 
callback 


The callback routine or routines called when the value of the scale 
changes. This argument sets the value_changed_callback attribute 
described in the low-level routine SCALE CREATE. 


drag_callback 


A callback routine or routines called because the user is dragging the 
slider. 


help_callback 


The callback routine or routines called on a help request. 


High-Level Widget Routines 
SCALE 


DESCRIPTION _ See the low-level routine SCALE CREATE. 
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SCALE GET SLIDER 


Gets the current value of the slider position displayed in the scale. 





VAX FORMAT void = DWT$SCALE_GET SLIDER (widget, value) 


argument 


information Argent Uae Gees Access Neca 


widget widget uns longword read reference 
value longword longword write reference 





MITC FORMAT void=DwtScaleGetSlider (widget, value) 


argument 

information void DwtScaleGetSlider (widget, value) 
Widget widget; 
int xvalue; 





ARGUMENTS __ widget 
The identifier of the scale widget. 


value 


The current slider position value. 





DESCRIPTION SCALE GET SLIDER retrieves the current slider position for the 
application. See the related routine SCALE. 
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SCALE SET SLIDER 


Sets or changes the current value of the slider position displayed in the scale. 





VAX FORMAT  void=DWT$SCALE_SET SLIDER (widget, value) 


argument 


information Argument ‘Usage —siDataype === Access_-~=—Ss Mechanism 


widget widget uns longword read reference 
value longword longword read reference 





MIT C FORMAT void = DwtScaleSetSlider (widget, value) 


argument 

information void DwtScaleSetSlider (widget, value) 
Widget widget; 
int value; 





ARGUMENTS widget 


The identifier of the scale widget. 


value 
The new slider position for the scale. This argument sets the value 
attribute described in the low-level routine SCALE CREATE. 





DESCRIPTION SCALE SET SLIDER sets or changes the current slider position within the 
scale widget display for the application. See the related routine SCALE 
and SCALE GET SLIDER. 
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SCROLL BAR 


Creates a scroll bar widget. 





VAX FORMAT 


argument 
information 
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widget = DWT$SCROLL_BAR 
(parent_widget, name, x, y, width, height, inc, 
page_inc, shown, int_value, min_value, max_value, 
orientation, callback, help_callback, unit_inc_callback, 
unit_dec_callback, page_inc_callback, 
page_dec_callback, to_top_callback, 


to_bottom_callback, drag_callback ) 


Argument 


widget 
parent_widget 
name 

X 

y 

width 

height 

inc 

page_inc 

shown 

int_value 
min_value 
max_value 
orientation 
callback 
help_callback 
unit_inc_callback 
unit_dec_callback 
page_inc_callback 
page_dec_callback 
to_top_callback 
to_bottom_callback 
drag_callback 


Usage 


widget 
widget 
char string 
position 
position 
dimension 
dimension 
longword 
longword 
longword 
longword 
longword 
longword 
uns byte 
callback 
callback 
callback 
callback 
callback 
callback 
callback 
callback 
callback 


Data Type 


uns longword 
uns longword 
char string 
longword 
longword 

uns longword 
uns longword 
longword 
longword 
longword 
longword 
longword 
longword 

uns longword 
uns longword 
uns longword 
uns longword 
uns longword 
uns longword 
uns longword 
uns longword 
uns longword 
uns longword 


Access 


write 
read 
read 
read 
read 
read 
read 
read 
read 
read 
read 
read 
read 
read 
read 
read 
read 
read 
read 
read 
read 
read 
read 


Mechanism 


value 

reference 
descriptor 
reference 
reference 
reference 
reference 
reference 
reference 
reference 
reference 
reference 
reference 
reference 
reference 
reference 
reference 
reference 
reference 
reference 
reference 
reference 
reference 
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MITC FORMAT widget = DwtScrollBar 
(parent_widget, name, x, y, width, height, inc, 
page_inc, shown, int_value, min_value, max_value, 
orientation, callback, help_callback, unit_inc_callback, 
unit_dec_callback, page_inc_callback, 
page_dec_callback, to_top_callback, 
to_bottom_callback, drag_callback ) 





argument 
information Widget DwtScrollBar (parent_widget, name, x, Yr width, height, 
inc, page_inc, shown, int_value, min_value, 
max value, orientation, callback, 
help callback, unit_inc_callback, 
unit_dec_callback, page_inc_callback, 
page_dec_callback, to_top_ callback, 
to _bottom_callback, drag callback) 
Widget parent_widget; 
char *name; 
Position x; 
Position Vi 
Dimension width; 
Dimension height; 
int Ine; 
int page_inc; 
int shown; 
int int_value; 
int min value; 
int max value; 
unsigned char orientation; 
DwtCallbackPtr callback; 
DwtCallbackPtr help callback; 
DwtCallbackPtr unit_inc_callback; 
DwtCallbackPtr unit_dec_callback; 
DwtCallbackPtr page_inc callback; 
DwtCallbackPtr page _dec_callback; 
DwtCallbackPtr to_top_ callback; 
DwtCallbackPtr to _bottom_callback; 
DwtCallbackPtr drag callback; 
RETURNS widget 


The identifier of the created widget. 





ARGUMENTS _ parent_widget 
The identifier of the parent widget. 


name 
The name of the created widget. 


xX 

The placement, in pixels, of the left side of the widget window relative to © 
the inner upper left corner of the parent window. This argument sets the 
core widget x attribute described in Section 8.2. 
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The placement, in pixels, of the top of the widget window relative to the 
inner upper left corner of the parent window. This argument sets the core 
widget y attribute described in Section 8.2. 


width 


The width of the widget. This argument sets the core widget width 
attribute described in Section 8.2. 


height | 
The height of the widget. This argument sets the core widget height 
attribute described in Section 8.2. 


ince 
The amount of button increment and decrement. If this argument is not 
zero, the widget automatically adjusts the slider when a unit increment 


or unit decrement action occurs. This argument sets the inc attribute 
described in the low-level routine SCROLL BAR CREATE. 


page_inc 

The amount of page increment and decrement. If this argument is not 
zero, the widget automatically adjusts the slider when a page increment or 
page decrement action occurs. This argument sets the page_inc attribute 
described in the low-level routine SCROLL BAR CREATE. 


shown 

The size of the slider as a value between zero and the absolute value of 
max_value minus min_value. The size of the slider varies, depending 
on how much of the slider scroll area it represents. This argument sets 
the shown attribute described in the low-level routine SCROLL BAR 
CREATE. 


int_value 

The position of the top or left end of the scroll bar’s slider. This argument 
sets the int_value attribute described in the low-level routine SCROLL 
BAR CREATE. 


min_value 
The scroll bar’s minimum value. This argument sets the min_value 
attribute described in the low-level routine SCROLL BAR CREATE. 


max_value 


The scroll bar’s maximum value. This argument sets the max_value 
attribute described in the low-level routine SCROLL BAR CREATE. 


orientation 


The orientation of the scroll bar. The predefined values for this argument 
are as follows: 


VAX Cc Description 
DWT$C_ORIENTATION__ DwtOrientationHorizontal Horizontal scroll 
HORIZONTAL bar 


High-Level Widget Routines 
| SCROLL BAR 


VAX Cc Description 


DWT$C_ORIENTATION_VERTICAL DwtOrientationVertical Vertical scroll 
bar 


This argument sets the orientation attribute described in the low-level 
routine SCROLL BAR CREATE. 


callback 


The callback routine or routines called when the value of the scroll bar 
changes. This argument sets the value_changed_callback attribute 
described in the low-level routine SCROLL BAR CREATE. 


help_callback 
The callback routine or routines called on a help request. This argument 
sets the help_callback attribute described in Section 8.2. 


unit_inc_callback 

The callback routine or routines called because the user selected the unit 
increment scroll function. This argument sets the unit_inc_callback 
described in the low-level routine SCROLL BAR CREATE. 


unit_dec_callback 

A widget-specific callback routine because the user selected the unit 
decrement function. This argument sets the unit_dec_callback described 
in the low-level routine SCROLL BAR CREATE. 


page_inc_callback 

The callback routine or routines called because the user selected the page 
increment function. This argument sets the page_inc_callback described 
in the low-level routine SCROLL BAR CREATE. 


page_dec_callback 

The callback routine or routines called because the user selected the page 
decrement scroll function. This argument sets the page_dec_callback 
described in the low-level routine SCROLL BAR CREATE. 


to top callback 

The callback routine or routines called because the user selected the to-top 
scroll function. This argument sets the to_top_callback described in the 
low-level routine SCROLL BAR CREATE. 


to_bottom_callback 

The callback routine or routines called because the user selected the 
to-bottom scroll function. This argument sets the to_bottom_callback 
described in the low-level routine SCROLL BAR CREATE. 


drag_callback 

The callback routine or routines called because the user is dragging the 
scroll bar slider. This argument sets the drag_callback described in the 
low-level routine SCROLL BAR CREATE. 





DESCRIPTION _ See the low-level routine SCROLL BAR CREATE. 
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SCROLL BAR GET SLIDER 


Retrieves the current size and position parameters of the slider in the scroll 
bar widget. 





VAX FORMAT void=DWT$SCROLL_BAR_GET_SLIDER 
(widget, value, shown, inc, page_inc) 


argument 

information Argument Usage Data Type Access Mechanism 
widget widget uns longword read reference 
value longword longword write reference 
shown longword longword write reference 
inc longword longword write reference 
page_inc longword longword write reference 





MIT C FORMAT = svoid = DwtScrollBarGetSlider 
(widget, value, shown, inc, page_inc) 


argument 
information void DwtScrollBarGetSlider (widget, value, shown, inc, page_inc) 
Widget widget; 
int *value; 
int *shown; 
int *xinc; 
int *page_inc; 





ARGUMENTS _ widget 


The identifier of the scroll bar widget. 


value 
The top or left end of the scroll bar’s slider as a value between min_value 
and max_value. 


shown 
The size of the slider as a value between zero and the absolute value of 
max_value minus min_value. 


inc 
The amount of button increment and decrement. 
page_inc 


The amount of page increment and decrement. 
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DESCRIPTION SCROLL BAR GET SLIDER retrieves the currently-displayed scroll bar 
widget slider size and position parameters for the application. See the 
related routines SCROLL BAR and SCROLL BAR SET SLIDER. 
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SCROLL BAR SET SLIDER 


Sets or changes the current size/position parameters of the slider in the scroll 
bar widget. 





VAX FORMAT  void=DWT$SCROLL_BAR_SET_ SLIDER 
(widget, value, shown, inc, page_inc, notify) 





argument 

information Argument Usage Data Type Access Mechanism 
widget widget uns longword read reference 
value longword longword read reference 
shown longword longword read reference 
inc longword longword read reference 
page_inc longword longword read reference 
notify Boolean uns longword read reference 





MIT C FORMAT void = DwtScrollBarSetSlider 
(widget, value, shown, inc, page_inc, notify) 


argument | 
information void DwtScrollBarSetSlider(widget, value, shown, inc, page_inc, 
notify) 
Widget widget; 
int value; 
int shown; 
int inc; 
int page_inc; 


Boolean notify; 





ARGUMENTS ~~ widget 
The identifier of the scroll bar widget. 


value 

The scroll bar’s slider position between the min_value and max_value 
arguments to the scroll bar widget. This argument sets the int_value 
attribute described in the low-level routine SCROLL BAR CREATE. 


shown 

The size of the slider as a value between zero and the absolute value of 
max_value minus min_value. The size of the slider varies, depending 
on how much of the slider scroll area it represents. This argument sets 
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the shown attribute described in the low-level routine SCROLL BAR 
CREATE. 


inc 
The amount of button increment and decrement. If this argument is not 
zero, the widget automatically adjusts the slider when an increment or 


decrement action occurs. This argument sets the ine attribute described 
in the low-level routine SCROLL BAR CREATE. 


page_inc 
The amount of page increment and decrement. If this argument is not 
zero, the widget automatically adjusts the slider when an increment 


decrement action occurs. This argument sets the page_inc attribute 
described in the low-level routine SCROLL BAR CREATE. 


notify 

A Boolean attribute that, if true, causes the scroll bar widget to call the 
value changed callback if its value changes as a result of the SCROLL 
BAR SET SLIDER routine. If false, the callback does not occur. 


DESCRIPTION SCROLL BAR SET SLIDER sets or changes the currently displayed scroll 
ar widget slider parameters for the application. See the related routines 
SCROLL BAR and SCROLL BAR GET SLIDER. 
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SCROLL WINDOW 


Creates a scroll window widget. 





VAX FORMAT _ widget = DWT$SCROLL_WINDOW 
(parent_widget, name, x, y, width, height) 


argument 

information Argument Usage Data Type Access Mechanism 
widget widget uns longword write value 
parent_widget widget uns longword read reference 
name char string char string read descriptor 
Xx position longword read reference 
y position longword read reference 
width dimension uns longword read reference 
height dimension uns longword read reference 





MIT CFORMAT widget = DwtScrollWindow 
(parent_widget, name, x, y, width, height) 





argument 
information Widget DwtScrollWindow(parent_ widget, name, x, y, 
width, height) 
Widget parent _widget; 
char *name; 
Position x; 
Position yi 
Dimension width; 
Dimension height; 
RETURNS widget 


The identifier of the created widget. 





ARGUMENTS _ parent_widget | 
The identifier of the parent widget. 


name 
The name of the created widget. 


7-80 


High-Level Widget Routines 
SCROLL WINDOW 


xX 

The placement, in pixels, of the left side of the widget window relative to 
the inner upper left corner of the parent window. This argument sets the 
core widget x attribute described in Section 8.2. 


The placement, in pixels, of the top of the widget window relative to the 
inner upper left corner of the parent window. This argument sets the core 
widget y attribute described in Section 8.2. 


width 


The width of the window in pixels. This argument sets the core widget 
width attribute described in Section 8.2. 


height | 
The height of the window in pixels. This argument sets the core widget 
height attribute described in Section 8.2. 





DESCRIPTION _ See the low-level routine SCROLL WINDOW CREATE. 
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SCROLL WINDOW SET AREAS 


Specifies the widgets that are to serve as the work area, horizontal scroll bar, 
and vertical scroll bar widgets for the scroll window widget. 





VAX FORMAT _—- void = DWT$SCROLL_WINDOW_SET_AREAS 
(widget, h_scroll, v_scroll, work_region) 


argument 

information Argument Usage Data Type Access Mechanism 
widget widget uns longword read reference 
h_scroll widget uns longword read reference 
v_scroll widget uns longword read reference 
work_region widget uns longword read reference 





MIT C FORMAT void = DwtScrollWindowSetAreas 
(widget, h_scroll, v_scroll, work_region) 


argument 
information void DwtScrollWindowSetAreas (widget, h_scroll, v_scroll, 
work_region) 
Widget widget; 
Widget h_scroll; 
Wdiget v_scroll; 
Widget work_region; 





ARGUMENTS _ widget 


The identifier of the created widget. 
h_scroll 


The widget identifier for the horizontal scroll bar for the scroll window 
widget. 

v_scroll 

The widget identifier for the vertical scroll bar for the scroll window 
widget. 


work_region 


The widget identifier for the window to serve as the scroll window work 
area, 
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DESCRIPTION SCROLL WINDOW SET AREAS enables you to specify the window work 
area, a horizontal scroll bar, and a vertical scroll bar for the scroll window 
widget. Each area is optional and may be passed as null. See the related 
routine SCROLL WINDOW. 
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SELECTION 


Creates a selection widget. 





VAX FORMAT widget = DWT$SELECTION 
(parent_widget, name, x, y, title, value, items, 
item_count, visible_item_count, style, default_position, 
callback, help_callback) 
argument 
information Argument Usage Data Type Access Mechanism 
widget widget uns longword write value 
parent_widget widget uns longword read reference 
name _ char string char string read descriptor 
X position longword read reference 
y position longword read reference 
title comp string uns longword read reference 
value comp string uns longword read reference 
items array uns longword read reference 
item_count longword longword read reference 
visible_item_count longword longword read reference 
style uns longword uns longword read reference 
default_position Boolean uns longword read reference 
callback callback uns longword read reference 
help_callback callback uns longword read reference 





MITC FORMAT widget = DwtSelection | 


(parent_widget, name, x, y, title, value, items, 
item_count, visible_item_count, style, default_position, 
callback, help_callback) 


7-84 


High-Level Widget Routines 
SELECTION 








argument 
information Widget DwtFileSelection(parent_widget, name, 
x, y, title, value, items, 
items count, visible item _count, style, 
default position, 
; callback, help callback) 
Widget parent _widget; 
char *name; 
Position ba 
Position Yi 
DwtCompString title; 
DwtCompString value; 
DwtCompString *items; 
int item_count; 
int visible _item_count; 
int style; 
Boolean default_position; 
DwtCallbackPtr callback; 
DwtCallbackPtr help callback; 
RETURNS widget 
The identifier of the created widget. 
ARGUMENTS _ parent_widget 


The identifier of the parent widget. 
name 


The name of the created widget. 


X 

The placement, in pixels, of the left side of the widget window relative to 
the inner upper left corner of the parent window. This argument sets the 
core widget x attribute described in Section 8.2. 


The placement, in pixels, of the top of the widget window relative to the 
inner upper left corner of the parent window. This argument sets the core 
widget y attribute described in Section 8.2. 


title 
The text that appears in the window banner. This argument sets the title 
attribute described in the low-level routine DIALOG BOX CREATE. 


value 
The text in the text edit field. This argument sets the value attribute 
described in the low-level routine SELECTION CREATE. 


items 
The items in the selection widget. This argument sets the items attribute 
described in the low-level routine SELECTION CREATE. 


High-Level Widget Routines 





SELECTION 
item_count 
The number of items in the selection widget. This argument sets the 
item_count attribute described in the low-level routine SELECTION 
CREATE. 
visible_item_count 
The number of items displayed in the list box. This argument sets 
the visible_item_count attribute described in the low-level routine 
SELECTION CREATE. 
style 
The style of the pop-up dialog box. The predefined values for this attribute 
are as follows: 
VAX Cc Description 
DWT$C_MODAL DwtModal Modal 
DWT$C_MODELESS DwtModeless Modeless 
This argument sets the style attribute described in the low-level routine 
DIALOG BOX POPUP CREATE. 
default_position 
A Boolean attribute that, if true, causes the core attributes x and y to be 
ignored and forces the default widget position. The default widget position 
is centered in the parent window. If false, the specified x and y attributes 
are used to position the widget. This argument sets the default_position 
attribute described in the low-level routine DIALOG BOX CREATE. 
callback 
A callback routine or routines called when a selection is made, a selection 
is canceled, or when there is no match for an item selected. This argument 
sets the activate_callback, cancel_callback, and no_match_callback 
attributes described in the low-level routine SELECTION CREATE. 
help_callback 
The callback routine or routines called on a help request. 
DESCRIPTION _ See the low-level routine SELECTION CREATE. 
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SEPARATOR 
Creates a separator widget. 
VAX FORMAT _— widget = DWT$SEPARATOR 
(parent_widget, name, x, y, orientation) 
argument 
information Argument Usage Data Type Access Mechanism 
widget widget uns longword write value 
parent_widget widget uns longword read reference 
name char string char string read descriptor 
Xx position longword read reference 
y position longword read reference 
orientation uns byte uns longword read reference 
MIT C FORMAT widget = DwtSeparator 
(parent_widget, name, x, y, orientation) 
argument 
information Widget DwtSeparator (parent widget, name, x, y, orientation) 
Widget parent_widget; 
char *name; 
Position x; 
Position vy; 
unsigned char orientation; 
RETURNS widget 


The identifier of the created widget. 





ARGUMENTS _ parent_widget 
The identifier of the parent widget. 


name 


The name of the created widget. 


X 

The placement, in pixels, of the left side of the widget window relative to 
the inner upper left corner of the parent window. This argument sets the 
core widget x attribute described in Section 8.2. 
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SEPARATOR 
The placement, in pixels, of the top of the widget window relative to the 
inner upper left corner of the parent window. This argument sets the core 
widget y attribute described in Section 8.2. 
orientation 
The orientation of the scroll bar. The predefined values for this argument 
are as follows: 
VAX Cc Description 
DWT$C_ORIENTATION__ DwtOrientationHorizontal Horizontal scroll bar 
HORIZONTAL 
DWT$C_ORIENTATION.__ DwtOrientationVertical Vertical scroll bar 
VERTICAL 
This argument sets the orientation attribute described in the low-level 
routine SEPARATOR CREATE. 

DESCRIPTION See the low-level routine SEPARATOR CREATE. 
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S TEXT 


Creates a simple text widget. 





VAX FORMAT ~~ widget = DWT$S_TEXT 
(parent_widget, name, x, y, cols, rows, string_value) 


argument 

information Argument Usage Data Type Access Mechanism 
widget widget uns longword write value 
parent_widget widget uns longword read reference 
name char string char string read descriptor 
X position longword read reference 
y position longword read reference 
cols longword longword read reference 
rows longword longword read reference 
string_value char string char string read descriptor 





MITC FORMAT widget = DwtSText 
(parent_widget, name, x, y, cols, rows, string_value) 





argument 
information Widget DwtSText (parent _widget, name, x, y, cols, rows, 
string value) 
Widget parent widget; 
char *Aname; 
Position x; 
Position y; 
int cols; 
ant rows; 
char *string value; 
RETURNS widget 


The identifier of the created widget. 





ARGUMENTS __ parent_widget 
The identifier of the parent widget. 


name 
The name of the created widget. 
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xX 
The placement, in pixels, of the left side of the widget window relative to 
the inner upper left corner of the parent window. This argument sets the 
core widget x attribute described in Section 8.2. 
The placement, in pixels, of the top of the widget window relative to the 
inner upper left corner of the parent window. This argument sets the core 
widget y attribute described in Section 8.2. 
cols 
The width of the text window measured in character cells. This argument 
sets the cols attribute described in the low-level routine S TEXT CREATE. 
rows 
The height of the text window measured in character cells or number of 
lines. This argument sets the rows attribute described in the low-level 
routine S TEXT CREATE. 
string_value 
The actual text to display. This argument sets the value attribute 
described in the low-level routine S TEXT CREATE. 

DESCRIPTION _ See the low-level routine S TEXT CREATE. 
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S TEXT CLEAR SELECTION 


Clears the global selection highlighted in the simple text widget. 





VAX FORMAT void=DWT$S_TEXT_CLEAR_SELECTION 
(widget, time) 


argument 
information Argument Usage Data Type Access Mechanism 
widget widget uns longword read reference 


time date time uns longword read reference 





MIT C FORMAT void = DwtSTextClearSelection 
(widget, time) 


argument 
information void DwtSTextClearSelection(widget, time) 
Widget widget; 

Time time; 





ARGUMENTS _ widget 


The identifier of the simple text widget. 


time 

The time of the event that led to the call to SET SELECTION. You can 
pass either a timestamping or CurrentTime. However, whenever possible 
use the timestamping of the event leading to the call. 





DESCRIPTION _ § TEXT clears the global selection highlighted in the simple text widget. 
See the related routines S TEXT, S TEXT SET SELECTION, and S TEXT 
GET SELECTION. | 
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S TEXT GET EDITABLE 


Obtains the current permission state concerning whether the text in the simple 
text widget can be edited by the user. 





VAX FORMAT editable = DWT$S_TEXT_GET_EDITABLE (widget) 


argument 


information Argument Usage —‘DataType —=—sAccess_~=—Ss Mechanism —__ 


editable Boolean uns longword write write 
widget widget uns longword read reference 





MIT C FORMAT editable = DwtSTextGetEditable (widget) 





argument 

information Boolean DwtSTextGetEditable (widget) 
Widget widget; 

RETURNS editable 


A Boolean attribute that, if true, indicates the user can edit the string text 
in the simple text widget. When false, the user cannot edit the text string. 





ARGUMENTS _ widget 
The identifier of the simple text widget. 





DESCRIPTION 8S TEXT GET EDITABLE returns the current permission state concerning 
whether the text in the simple text widget can be edited by the user. See 
the related routines S TEXT and S TEXT SET EDITABLE. 
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S TEXT GET MAX LENGTH 


Obtains the current maximum allowable length of the text string in the simple 
text widget. 





VAX FORMAT max_len = DWT$S_TEXT_GET_MAX_LENGTH 


(widget) 
argument 
information Argument Usage Data Type Access Mechanism 
max_len uns longword uns longword write reference 
widget widget uns longword read reference 





MITC FORMAT max_len =DwtSTextGetMaxLength 





(widget) 
argument 
information int DwtSTextGetMaxLength (widget) 
Widget widget; 
RETURNS max_len 
The maximum length, in characters, of the text string in the simple text 
widget. 





ARGUMENTS __ widget 


The identifier of the simple text widget. 





DESCRIPTION _ §S TEXT GET MAX LENGTH returns the current maximum allowable 
length of the text string in the simple text widget. See the related routines 
S TEXT and S TEXT SET MAX LENGTH. 
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S TEXT GET SELECTION 


Retrieves the global selection, if any, currently highlighted in the simple text 


widget. 





VAX FORMAT 


argument 
information 


void = DWT$S_TEXT_GET_SELECTION 
(widget, selection, selection_len) 


Argument Usage Data Type Access Mechanism 


widget widget uns longword read reference 
selection identifier char string write descriptor 
selection_len uns longword —_ uns longword write reference 





MIT C FORMAT selection = DwtSTextGetSelection 


argument 
information 


RETURNS 


(widget) 


char *DwtSTextGetSelection (widget) 
char *selection; 
Widget widget; 


selection (C only) 
A pointer to the text string. 





ARGUMENTS 


widget 
The identifier of the simple text widget. 


selection (VAX only) 
A pointer to the text string selected. 


selection_len (VAX only) 
The length of the text string. 





DESCRIPTION 
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S TEXT GET SELECTION retrieves the text currently selected in the 
simple text widget. It returns a null pointer if no text is selected in the 
widget. The application is responsible for freeing the storage associated 
with the text string by calling the intrinsic routine FREE. 


See the related routines S TEXT, S TEXT SET SELECTION, and S TEXT 
CLEAR SELECTION. 
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S TEXT GET STRING 


Retrieves the text string from the simple text widget. 





VAX FORMAT _ void=DWT$S_TEXT_GET_STRING 
(widget, string_value, string_len) 


argument 

information Argument Usage Data Type Access Mechanism 
widget widget uns longword read reference 
string_value identifier char string write descriptor 
string_len uns longword —_ uns longword write reference 





MIT C FORMAT -sstring_value = DwtSTextGetString 





(widget) 
argument 
information char *DwtSTextGetString (widget) 
Widget widget; 
RETURNS string_value (C only) 


A pointer to the current text string in the simple text widget. 





ARGUMENTS'~~_ widget 


The identifier of the simple text widget. 


string_value (VAX only) 


The current text string in the simple text widget. 


string_len (VAX only) 


The length of the text string. 





DESCRIPTION  § TEXT GET STRING retrieves the current string from the simple text 
widget. When using the MIT C binding, the application is responsible 
for freeing the storage associated with the string by calling the intrinsic 
routine FREE. See the related routines S TEXT, S TEXT SET STRING, 
and S TEXT REPLACE. 
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S TEXT REPLACE 


Replaces a portion of the current text string in the simple text widget or inserts 
a new substring in the text. 





VAX FORMAT void = DWT$S_TEXT_REPLACE 
| (widget, from_pos, to_pos, value) 


argument 

information Argument Usage Data Type Access Mechanism 
widget widget uns longword read reference 
from_pos longword longword read reference 
to_pos longword longword read reference 
value char string char string read descriptor 





MITC FORMAT void = DwtSTextReplace 
| (widget, from ) pos, to_pos, value) 


argument 
information void DwtXTextReplace (widget, from_pos, to _pos, value) 
Widget widget; 
int from_pos; 
int to_pos; 
char *value; 





ARGUMENTS _ widget 
The identifier of the simple text widget. 


from_pos 
The first character position of the text string being replaced. 


to_pos 


The last character position of the text string being replaced. 


value 
The text to replace part of the current text in the simple text widget. 
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DESCRIPTION 5S TEXT REPLACE replaces part of the text string in the simple text 
widget. Within the widget, positions are numbered starting at 0 and 
increase sequentially. For example, to replace the second and third 
characters in the string, from_pos should be 1 and to_pos should be 
3. To insert a string after the fourth character, from_pos and to_pos 
should both be 4. See the related routine S TEXT, S TEXT SET STRING, 
and S TEXT GET STRING. 
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S TEXT SET EDITABLE 


Sets the permission state that determines whether the text in the widget can 
be edited by the user. 





VAX FORMAT void =DWT$S_TEXT_SET_ EDITABLE 
(widget, editable) 


argument 

information Argument Usage Data Type Access Mechanism 
widget widget uns longword read reference 
editable Boolean uns longword read reference 





MITC FORMAT void = DwtSTextSetEditable 
(widget, editable) 


argument 

information void DwtSTextSetEditable(widget, editable) 
Widget widget; 
Boolean editable; 





ARGUMENTS ~~ widget 


The identifier of the simple text widget. 
editable 


A Boolean attribute that, if true, indicates the user can edit the string text 
in the simple text widget. When false, the user cannot edit the text string. 





DESCRIPTION _— S TEXT SET EDITABLE sets the permission state concerning whether 
text in the simple text widget can be edited by the user. See the related 
routines S TEXT and S TEXT GET EDITABLE. 
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S TEXT SET MAX LENGTH 


Sets the maximum allowable length of the text string in the simple text widget. 





VAX FORMAT = void =DWT$S_TEXT_SET_MAX_LENGTH 
(widget, max_len) 


argument 

information Argument Usage Data Type Access Mechanism 
widget widget uns longword read reference 
max_len longword longword read reference 





MIT C FORMAT void = DwtSTextSetMaxLength 
(widget, max_len) 


argument 

information void DwtSTextSetMaxLength (widget, max len) 
Widget widget; 
int max _len; 





ARGUMENTS _ widget 


The identifier of the simple text widget. 


max_len 

The maximum length, in characters, of the text string in the simple 
text widget. This argument sets the max_len attribute described in the 
low-level routine S TEXT CREATE. 





DESCRIPTION X TEXT SET MAX LENGTH sets the maximum allowable length of the 
text in the simple text widget. It prohibits the user from entering text 
strings longer than this limit. See the related routines S TEXT and 
S TEXT GET MAX LENGTH. 
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S TEXT SET SELECTION 


Makes specified text in the simple text widget the current global selection and 
highlights it in the simple text widget. 





VAX FORMAT void = DWT$S_TEXT_SET_SELECTION 
(widget, first, last, time) 


argument 

information Argument Usage Data Type Access Mechanism 
widget widget uns longword read reference 
first longword longword read reference 
last longword longword read reference 
time date time uns longword read reference 





MIT C FORMAT void = DwtSTextSetSelection 
(widget, first, last, time) 


argument 
information void DwtXTextSetSelection (widget, first, last, time) 
Widget widget; 
int first; 
int last; 
Time time; 





ARGUMENTS __ widget 
The identifier of the simple text widget. 


first 
The first character position of the text string being selected. 


last 


The last character position of the text string being selected. 
time 
Specifies the time of the event that led to the call to SET SELECTION. 


You can pass either a timestamping or CurrentTime. However, whenever 
possible use the timestamping of the event leading to the call. 
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DESCRIPTION §& TEXT SET SELECTION makes specified text in the simple text widget 
the current global selection and highlights it in the simple text widget. 
Within the text window, first marks the first character position and last 
marks the last position. The field characters start at 0 and increase 
sequentially. See the related routines S TEXT, S TEXT GET SELECTION, 
S TEXT CLEAR SELECTION, and S TEXT SET SELECTION. 
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S TEXT SET STRING 


Sets the text string in the simple text widget. 





VAX FORMAT void = DWT$S_TEXT_SET_STRING 
(widget, string_value) 


argument 


information Argument Usage —~Data Type ~=—SAccess.—~—Ss Mechanism 


widget widget uns longword read reference 
string_value identifier char string read descriptor 





MIT C FORMAT void = DwtSTextSetString 
(widget, string_value) 


argument 

information void DwtSTextSetString (widget, string _value) 
Widget widget; 
char *string value; 





ARGUMENTS _~_ widget 


The identifier of the simple text widget. 


string_value 
The text that replaces all text in the current simple text widget. 





DESCRIPTION 8 TEXT SET STRING completely changes the text string in the simple 
text widget. See the related routines S TEXT and S TEXT GET STRING. 


7-102 


High-Level Widget Routines 
TOGGLE BUTTON 


TOGGLE BUTTON 


Creates a toggle button widget. 





VAX FORMAT ~~ _ widget = DWT$TOGGLE_BUTTON 
(parent_widget, name, x, y, label, value, callback, 
help_callback) 


argument 

information Argument Usage Data Type Access Mechanism 
widget widget uns longword write value 
parent_widget widget uns longword read reference 
name char string char string read descriptor 
X position longword read reference 
y position longword read reference 
label comp string uns longword read reference 
value Boolean uns longword read reference 
callback callback uns longword read. reference 
help_callback — callback uns longword read reference 





MITC FORMAT widget = DwtToggleButton 
(parent_widget, name, x, y, label, value, callback, 
helo_callback) 





argument 
i i Widget DwtToggleButton(parent_widget, name, x, y, label, 
information value, callback, help callback) 
Widget parent_widget; 
char *name; 
Position x; 
Position Vi 
DwtCompString label; 
Boolean value; 
DwtCallbackPtr callback; 
DwtCallbackPtr help callback; 
RETURNS widget 


The identifier of the created widget. 
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ARGUMENTS _ parent_widget 
The identifier of the parent widget. 


name 
The name of the created widget. 


xX 

The placement, in pixels, of the left side of the widget window relative to 
the inner upper left corner of the parent window. This argument sets the 
core widget x attribute described in Section 8.2. 


The placement, in pixels, of the top of the widget window relative to the 
inner upper left corner of the parent window. This argument sets the core 
widget y attribute described in Section 8.2. 


label 


The text of the button label. This argument sets the label attribute 
described in the low-level routine LABEL CREATE. 


value 


The value of the toggle button, which can be either true or false. This 
argument sets the value attribute described in the low-level routine 
TOGGLE BUTTON CREATE. 


callback 


A callback routine or routines called when the value of the toggle button 
changes. This argument sets the value_changed_callback attribute 
described in the low-level routine TOGGLE BUTTON CREATE. 


help_callback 


The callback routine or routines called on a help ee 





DESCRIPTION _ See the low-level routine TOGGLE BUTTON CREATE. 
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TOGGLE BUTTON GET STATE 


Retrieves the current state of the toggle button. 





VAX FORMAT __ value = DWT$TOGGLE_BUTTON_GET_STATE 
(widget) 


argument 


information Argument | Usage —-DataType =~ Access_-~=—Ss Mechanism __ 


value Boolean uns longword write value 
widget widget uns longword read reference . 





MIT C FORMAT = va/ue = DwtToggleButtonGetState 





(widget) 
argument 
information Boolean DwtToggleButtonGetState (widget) 
Widget widget; 
RETURNS value 


The value of the toggle button. 


ARGUMENTS _ widget 
The identifier of the toggle button widget. 





DESCRIPTION TOGGLE BUTTON GET STATE retrieves the current state of the toggle 
button. See the related routine TOGGLE BUTTON. 
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TOGGLE BUTTON SET STATE 


Sets or changes the current state of the toggle button. 





VAX FORMAT = _ void = DWT$TOGGLE_BUTTON_SET_STATE 
(widget, value, notify) 


argument 

information Argument Usage Data Type Access Mechanism 
widget widget uns longword read reference 
value Boolean uns longword read reference 
notify Boolean uns longword read reference 





MIT C FORMAT void = DwtToggleButtonSetState 
(widget, value, notify) 


argument 

information void DwtToggleButtonSetState (widget, value, notify) 
Widget widget; 
Boolean value; 
Boolean notify; 





ARGUMENTS _ widget 


The identifier of the toggle button widget. 


value 

The value of the toggle button, which can be either true or false. This 
argument sets the value attribute described in the low-level routine 
TOGGLE BUTTON CREATE. 


notify 

A Boolean attribute that, if true, indicates that a change in the state of 
the toggle button has occurred and that the callback should be activated to 
respond to the recent change. If false, no change in state has occurred and 
no callback should be activated. 





DESCRIPTION TOGGLE BUTTON SET STATE sets or changes the current state of 
the toggle button within the display. See the related routine TOGGLE 
BUTTON. 
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WINDOW 


Creates a window widget. 





VAX FORMAT widget = DWT$WINDOW 
(parent_widget, name, x, y, width, height, callback) 


argument 

information - Argument Usage Data Type Access Mechanism 
widget widget uns longword write value 
parent_widget widget uns longword read reference 
name char string char string read descriptor 
X position longword read reference 
y position longword read reference 
width dimension uns longword read reference 
height dimension uns longword read reference 
callback callback uns longword read reference 





MITC FORMAT widget = DwtWindow 
(parent_widget, name, x, y, width, height, callback) 





argument 
information Widget DwtWindow(parent_widget, name, x, y, width, 
height, callback) 

Widget parent widget; 
char *Aname; 
Position X; 
Position Vi 
Dimension width; 
Dimension height; 
DwtCallbackPtr callback; 

RETURNS widget 


The identifier of the created widget. 





ARGUMENTS _ parent_widget 
The identifier of the parent widget. 


name 
The name of the created widget. 
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xX 

The placement, in pixels, of the left side of the widget window relative to 
the inner upper left corner of the parent window. This argument sets the 
core widget x attribute described in Section 8.2. 


The placement, in pixels, of the top of the widget window relative to the 
inner upper left corner of the parent window. This argument sets the core 
widget y attribute described in Section 8.2. 


width 


The width of the window in pixels. This argument sets the core widget 
width attribute described in Section 8.2. 


height 
The height of the window in pixels. This argument sets the core widget 
height attribute described in Section 8.2. 


callback 


The callback routine or routines called when an expose event occurs. This 
argument sets the expose_callback attribute described in the low-level 
routine WINDOW CREATE. 





DESCRIPTION 
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See the low-level routine WINDOW CREATE. 


WORK BOX 


Creates a work box widget. 


High-Level Widget Routines 


WORK BOX 





VAX FORMAT 


argument 
information 


widget = DWT$WORK_BOX 
(parent_widget, name, default_position, x, y, style, 
label, cancel_label, callback, help_callback) 


Argument 


widget 
parent_widget 
name 
default_position 
X 

y 

style 

label 
cancel_label 
callback 
help_callback 


Usage 


widget 
widget 
char string 
Boolean 
position 
position 
uns longword 
comp string 
comp string 
callback 
callback 


Data Type 


uns longword 
uns longword 
char string 
uns longword 
longword 
longword 

uns longword 
uns longword 
uns longword 
uns longword 
uns longword 


Access 


write 
read 
read 
read 
read 
read 
read 
read 
read 
read 
read 


Mechanism 


value 

reference 
descriptor 
reference 
reference 
reference 
reference 
reference 
reference 
reference 
reference 





MIT C FORMAT widget = DwtWorkBox 


argument 
information 


(parent_widget, name, default_position, x, y, style, 
label, cancel_label, callback, help_callback) 


Widget DwtWorkBox(parent_widget, name, default_position, 


x, y, style, label, cancel label, 
callback, help callback) 


Widget 

char 

Boolean 
Position 
Position 
unsigned char 
DwtCompString 
DwtCompString 
DwtCallbackPtr 
DwtCallbackPtr 


parent_widget; 
*name; 
default_position; 
x7 

y; 

style; 

label; 
cancel _ label; 
callback; 

help callback; 
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WORK BOX 
RETURNS widget 

The identifier of the created widget. 
ARGUMENTS _ parent_widget 
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The identifier of the parent widget. 


name 
The name of the created widget. 


default_position 

A Boolean attribute that, if true, causes the core attributes x and y to be 
ignored and forces the default widget position. The default widget position 
is centered in the parent window. If false, the specified x and y attributes 


are used to position the widget. This argument sets the default_position 
attribute described in the low-level routine DIALOG BOX CREATE. 


xX 

The placement, in pixels, of the left side of the widget window relative to 
the inner upper left corner of the parent window. This argument sets the 
core widget x attribute described in Section 8.2. 


The placement, in pixels, of the top of the widget window relative to the 
inner upper left corner of the parent window. This argument sets the core 
widget y attribute described in Section 8.2. 


style 
The style of the message box widget. The predefined values for this 
attribute are as follows: 


VAX Cc Description 


DWT$C_MODAL DwtModal Modal 
DWT$C_MODELESS  DwiModeless Modeless 


This argument sets the style attribute described in the low-level routine 
DIALOG BOX POPUP CREATE. 


label 


The text of the work box message. 


cancel_label 
The label for the Cancel push button. If the label is a null string, the 
button is not displayed. 


callback 


The callback routine or routines called when the Cancel button is 
activated. This argument sets the cancel_callback attribute described in 
the low-level routine WORK BOX CREATE. 


help_callback 


The callback routine or routines called on a help request. 


High-Level Widget Routines 
WORK BOX 


DESCRIPTION _ See the low-level routine WORK BOX CREATE. 
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The XUI Toolkit provides a set of low-level routines for widget creation. 
Unlike the high-level widget creation routines, low-level routines give the 
programmer access to all widget attributes. Having access to all widget 
attributes facilitates widget customization. The attributes of a particular 
widget include those inherited from superclass widgets and those specific 
to the widget. 


Table 8—1 lists the supported low-level widget routines. 


Table 8-1 Low-Level Widget Routines 
Routine Name Description 


ATTACHED DIALOG BOX CREATE _ Creates an attached dialog box widget. 


ATTACHED DIALOG POPUP BOX Creates an attached pop-up dialog box widget. 


CREATE 
CAUTION BOX CREATE 


COMMAND WINDOW CREATE 


DIALOG BOX CREATE 


DIALOG BOX POPUP CREATE - 


FILE SELECTION CREATE 
HELP CREATE 

LABEL CREATE 

LIST BOX CREATE 

MAIN WINDOW CREATE 
MENU BAR CREATE 
MENU CREATE 

MENU POPUP CREATE 
MENU PULLDOWN CREATE 
MESSAGE BOX CREATE 
OPTION MENU CREATE 


PULL DOWN MENU ENTRY 
CREATE 


PUSH BUTTON CREATE 
RADIO BOX CREATE 
SCALE CREATE 

SCROLL BAR CREATE 
SCROLL WINDOW CREATE 


Creates a caution box widget. 
Creates a command window widget. 
Creates a dialog box widget. 
Creates a pop-up dialog box widget. 
Creates a file selection widget. 
Creates a help widget. 

Creates a label widget. 

Creates a list box widget. 

Creates a main window widget. 
Creates a menu bar widget. 
Creates a menu widget. 

Creates a pop-up menu widget. 
Creates a pull-down menu. 

Creates a message box widget. 
Creates an option menu widget. 
Creates a pull-down menu entry widget. 


Creates a push button widget. 
Creates a radio box widget. 
Creates a scale widget. 
Creates a scroll bar widget. 
Creates a scroll window widget. 


(continued on next page) 
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Table 8-1 (Cont.) Low-Level Widget Routines 


Routine Name Description 

SELECTION CREATE Creates a selection widget. 
SEPARATOR CREATE Creates a separator widget. 

S TEXT CREATE Creates a simple text widget. 
TOGGLE BUTTON CREATE Creates a toggle button widget. 
WINDOW CREATE Creates a window widget. 
WORK BOX CREATE Creates a work box widget. 


8.1 Widget Class Hierarchy 


All widgets belong to classes that are arranged in a hierarchy. Some 
classes contain only one widget. For example, the push button class 
contains only the push button widget. Other classes contain multiple 
widgets. The menu and dialog classes each contain several widgets. 
Widget attributes reside in the widget classes. 


Inherited attributes are determined by the widget’s position in the widget 
class hierarchy. Within the widget class hierarchy, widgets inherit default 
values for attributes from all their superclass widgets. Figure 8-1 shows 
the widget class hierarchy. 


Because attributes of several of the top-level widget classes (core, 
composite, common) are inherited by the majority of widgets, these 
attributes are termed common attributes. Common attributes are 
described in the next section. 


Any exceptions to the rule that widgets inherit attributes from their 
superclass widgets are described in the Attribute Exceptions section in 
each routine. Exceptions take two forms: an inherited attribute is not 
supported by the widget, or the inherited attribute has a different default 
value from its superclass widget. 


Programmers can override the default value of inherited attributes and 
use widget-specific attributes by using the override_arglist argument 
found in each low-level routine. Each argument in the list is a name/value 
pair that describes attributes of the created widget. 





8.2 Common Attributes 
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This section describes the common attributes. These are core and common 
class attributes that are inherited by a majority of widgets. Because 

the composite class has no user settable attributes, none are listed 

here. 
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VAX 
ATTRIBUTE 
INFORMATION 


The following table lists the VAX bindings for the core and common class 


attributes: 

Attribute Usage 
Core Widget Attributes 

x position 

y position 
width dimension 
height dimension 
border_width dimension 
border pixel 
border_pixmap pixmap 
background pixel 
background_ pixmap 
pixmap 

colormap colormap 
sensitive Boolean 
ancestor_sensitive Boolean 
accelerators translations 
depth uns longword 
translations translations 
mapped_when_ Boolean 
managed 

screen screen 
destroy_callback callback 


Common Widget Attributes 


foreground 
highlight 


highlight_pixmap 


user_data 


direction_r_to_| 


font 
help_callback 


pixel 
pixel 
pixmap 
longword 
Boolean 
font list 
callback 


Data Type 


word 

word 

uns word 

uns word 
uns word 
uns longword 
uns longword 
uns longword 
uns longword 


uns longword 
uns byte 

uns byte 

uns longword 
uns longword 
uns longword 
uns longword 


uns longword 
uns longword 


uns longword 
uns longword 
uns longword 
uns longword 
uns longword 
uns longword 
uns longword 


Access 


read 
read 
read 
read 
read 
read 
read 
read 
read 


read 
read 
read 
read 
read 
read 
read 


read 
read 


read 
read 
read 
read 
read 
read 
read 


Mechanism 


value 
value 
value 
value 
value 
value 
value 
value 
value 


value 
value 
value 
reference 
value 
reference 
value 


reference 
reference 


value 
value 
value 
value 
value 
reference 
reference 
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MIT C The following C declarations are used for the core class attributes: 
ATTRIBUTE eosies ee 
INFORMATION = ®°sition yi 
Dimension width; 
Dimension height; 
Dimension border _width; 
Pixel border; 
Pixmap border_pixmap; 
Pixel background; 
Pixmap background_pixmap; 
Colormap colormap; 
Boolean sensitive; 
Boolean ancestor sensitive; 
XtTranslations accelerators; 
int depth; 
XtTranslations translations; 
Boolean mapped when_managed; 
Screen *screen; 
DwtCallbackPtr destroy callback; 
The following C declarations are used for the common class attributes: 
Pixel foreground; 
Pixel highlight; 
Pixmap highlight _pixmap; 
Opaque *user data; 
Boolean direction_r_to_1; 
DwtFontList font? 
DwtCallbackPtr help callback; 
X 


ATTRIBUTES 


VAX binding: DWT$C_NX 


C binding: 


DwtNx 


The placement, in pixels, of the left side of the widget window relative 
to the inner upper left corner of the parent window. The default is 


determined by the geometry manager. 


y 

VAX binding: DWT$C_NY 

C binding: DwtNy 

The placement, in pixels, of the top of the widget window relative to the 


inner upper left corner of the parent window. The default is determined by 
the geometry manager. 


width 
VAX binding: DWT$C_NWIDTH 
C binding: DwtNwidth 


The width of the widget window in pixels. The default is widget specific. 
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height 
VAX binding: DWT$C_NHEIGHT 
C binding: DwtNheight 


The height of the widget window in pixels. The default is widget specific. 


border_width 
VAX binding: DWT$C_NBORDER_WIDTH 
C binding: DwtNborderWidth 


The widget window border width in pixels. The default is 1 pixel. 


border 
VAX binding: DWT$C_NBORDER 
C binding: DwtNborder 


The widget window border color. The default is the default foreground 
color. 


border_pixmap 
VAX binding: DWT$C_NBORDER_PIXMAP 
C binding: DwtNborderPixmap 


The widget window border pattern and color. The default is null. 


background 
VAX binding: DWT$C_NBACKGROUND 
C binding: DwtNbackground 


The color of background objects in the widget window. The default is the 
default background. 


background_pixmap 
VAX binding: DWIT'$C_NBACKGROUND_PIXMAP 
C binding: DwtNbackgroundPixmap 


The color and pattern of background objects in the widget window. The 
default is null. 


colormap 
VAX binding: DWT$C_NCOLORMAP 
C binding: DwtNcolormap 


The color map used for the widget’s window. The default is the default 
color map. 


sensitive 
VAX binding: DWT$C_NSENSITIVE 
C binding: DwtNsensitive 


A Boolean attribute that indicates whether the widget reacts to input 
events. If true, the widget reacts to input events. If false, the widget 
ignores input events. The default is true. 


ancestor_sensitive 
VAX binding: DWT$C_NANCESTOR_SENSITIVE 
C binding: DwtNancestorSensitive 
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A Boolean attribute that indicates whether the parent widget is sensitive. 
If true, the parent is sensitive. If false, the parent is not sensitive. 
Applications can get the value of this attribute by using the intrinsic 
GET VALUES routine. An application should not explicitly set the value 
of this attribute. 


The default is the bitwise AND of the parent widget’s sensitive and 
ancestor_sensitive attributes. 


accelerators 
VAX binding: DWT$C_NACCELERATORS 
C binding: DwtNaccelerators 


A translation table that provides an alternate mode of access to widget 
functions. Accelerators allow applications to define keystrokes (in addition 
to clicking on a screen object with the mouse) to activate a function in a 
widget. 


depth 
VAX binding: DWT$C_NDEPTH 
C binding: DwtNDepth 


The widget window depth. This argument is set at widget creation time 
and cannot be changed by the intrinsic routine SET VALUES. The default 
is the depth of the parent window. 


translations 
VAX binding: DWT$C_NTRANSLATIONS 
C binding: DwtNtranslations 


The translation table containing the translation manager syntax for 
associating particular X events with particular widget events. See the 
VMS DECwindows Guide to Application Programming for information on 
translation tables. 


mapped_when_managed 
VAX binding: DWT$C_NMAPPED_WHEN_MANAGED 
C binding: DwtNmappedWhenManaged 


A Boolean attribute that, when true, causes the window to be displayed 
when managed. If false, the window is not displayed when managed. The 
default is true. 


screen 
VAX binding: DWT$C_NSCREEN 
C binding: DwtNscreen 


Points to the Xlib structure screen. See the display routines in the VMS 
DECwindows Xlib Routines Reference Manual for further information on 
screen. 


destroy_callback 
VAX binding: DWT$C_NDESTROY_CALLBACK 
C binding: DwtNdestroyCallback 


The callback routine or routines called when the widget is about to be 
destroyed. 
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foreground 
VAX binding: DWT$C_NFOREGROUND 
C binding: DwtNforeground 


The color of foreground objects in the widget window. The default is the 
default foreground. _ 


highlight 
VAX binding: DWT$C_NHIGHLIGHT 
Cbinding: DwtNhighlight 


Color used for highlighting. The default is foreground. 


highlight_pixmap 
VAX binding: DWT$C_NHIGHLIGHT_PIXMAP 
C binding: DwtNhighlightPixmap 


The pattern and color used for highlighting. The default is null. 


user_data 
VAX binding: DWT$C_NUSER_DATA 
C binding: DwtNuserData 


Any user private data to be associated with the widget. The default is 
null. 


direction_r_to_l 
VAX binding: DWT$C_NDIRECTION_R_TO_L 
C binding: DwtNdirectionRToL 


The direction in which the text is drawn. If false, text is drawn from left 
to right. If true, text is drawn from right to left. The default is false. 


font 
VAX binding: DWT$C_NFONT 
C binding: DwtNfont 


The font of the text used in the widget. The default is the default XUI 
Toolkit font. 


help_callback 
VAX binding: DWT$C_NHELP_CALLBACK 
C binding: DwtNhelpCallback 


The routine or routines called back on a help request. The default is null. 
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8.3 Callback Routines 


Note: 


Widgets communicate changes in state to the application that created 
them by means of callback routines. At creation time (or later using 

the intrinsic routine SET VALUES), an application specifies the callback 
routine or routines for a widget instance. Each widget has a (possibly null) 
set of reasons for issuing callbacks, depending upon how many changes 

in its state it is willing to communicate. An example of a callback reason 
is Value Changed. The application can specify one or more callback 
routines for each callback reason. 


Most widgets support the common help_callback attribute described in 
Section 8.2. 


The basic structure used when specifying callback routines for a callback 
reason is a null-terminated list of the following entries: 


typedef struct { 
void CallbackProc; 
Opaque tag; 

} DwtCallback, *DwtCallbackPtr; 


CallbackProc Specifies a pointer to the callback procedure entry point. 


tag Specifies any application-supplied value. This value is usually used 
by the application to uniquely identify a particular widget instance, 
and to allow one callback procedure to service multiple widget 
instances. 


The VAX binding names for DwtCallback and DwtCallbackPtr are 
DWT$CALLBACK and DWT$CALLBACK_PTR, respectively. 


By having more than one entry in a callback list for each callback reason 
supported by a widget, the application can specify more than one routine 
to be called back when the appropriate widget change in state occurs. 


For languages that cannot accept parameters to procedures by 
immediate value (like VAX PASCAL), the tag should be the address 
of the value to be returned. 


The callback structure for each widget contains at least two fields: reason 
and event. Widgets requiring only those two fields can use the standard 
callback structure (DwtAnyCallbackStruct in the C binding, 
DWT$ANY_CB_ST in the VAX binding). The format for a callback routine 
using the standard callback structure follows: 


typedef struct { 
int reason; 
XEvent *event; 

} ‘DwtAnyCallbackStruct; 


void CallbackProc (widget_id, tag, callback_data) 


Widget *widget_id; 
Opaque tag; 
DwtAnyCallbackStruct *callback_data 
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widget_id Identifier of the widget doing the callback. 
tag Tag provided when the callback was specified. 


callback_data Identifies a widget-specific data structure. Each XUI Toolkit widget 
callback data structure has at minimum reason and event fields. 


The reason field specifies the reason why this callback procedure was 
invoked. This field in the data structure is provided so that one callback 
routine can be called for multiple reasons, if the application desires. Each 
widget has a different set of callback reasons that are described in the 
Callback Reasons section in the routine descriptions. 


Some widgets have more complex callback structures. These are described 
in detail under the Callback Data Structure section of the particular 
routine. Table 8—2 lists the VAX and C callback structure names for all 
widgets. 


Table 8-2 Callback Structure Names 


Widget VAX Structure Name C Structure Name 

Any DWT$ANY_CB_ST DwtAnyCallbackStruct 

Menu DWT$MENU_CB_ST DwtMenuCallbackStruct 

Scroll Bar DWT$SCRL_BAR_CB_ST  DwtScrollBarCallbackStruct 
Toggle Button DWT$TOGGLE_CB_ST DwtToggleButtonCallbackStruct 
Window DWT$WINDOW_CB_ST DwtWindowCallbackStruct 
Scale DWT$SCALE_CB_ST DwtScaleCallbackStruct 

List Box DWT$LISTBOX_CB_ST DwtListBoxCallbackStruct 
Radio Box DWT$RADIOBOX_CB_ST DwtRadioBoxCallbackStruct 
Selection DWT$SEL_CB_ST DwtSelectionCallbackStruct 
File Selection DWT$FILSEL_CB_ST DwiFileSelectionCallbackStruct 


Command Box DWT$COMWIN_CB_ST DwtCommandWindowCallbackStruct 


After a widget has been created, an application should use the intrinsic 
routines ADD CALLBACK, ADD CALLBACKS, REMOVE CALLBACK, 
and REMOVE CALLBACKS to modify a widget callback list. Using the 
intrinsic routines SET VALUES and GET VALUES sets the entire callback 
list which may contain callbacks added by the parent widget. 


8.4 Low-Level Widget Routines 
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This section provides information about the low-level routines. See 
Chapter 1 for an explanation of the format used in the routines. 
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ATTACHED DIALOG BOX CREATE 


Creates an attached dialog box widget. 





WIDGET CLASS 
HIERARCHY beta 
| ae 
ere 
abs 


‘ 
attached dialog box 





VAX FORMAT _ widget =DWT$ATTACHED DB_CREATE 
(parent_widget, name, override_arglist, 
override_argcount) 


argument 

information Argument Usage . Data Type Access Mechanism 
widget widget uns longword write value 
parent_widget widget uns longword read reference 
name char string char string read descriptor 
override_arglist arglist uns longword read reference 
override_argcount uns longword uns longword read reference 

attribute 

information The following widget-specific attributes can be set in the override_ 
arglist: 
Attribute Usage Data Type Access Mechanism 
default_horizontal_offset longword longword read value 
default_vertical_offset longword longword read value 
rubber_positioning Boolean uns byte read value 
fraction_base longword longword read value 
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MIT C FORMAT 


argument 
information 


attribute 
information 


widget = DwtAttachedDBCreate 
(parent_widget, name, override_arglist, 
override_argcount) 


Widget DwtAttachedDBCreate (parent _widget, name, 
override_arglist, override_argcount) 
Widget parent widget; 
char *xname; 
ArgList override_arglist; 
int override argcount; 


The following widget-specific attributes can be set in the override_ 
arglist: 


int default_horizontal offset; 
int default _vertical offset; 
Boolean rubber positioning; 

int fraction_base; 





RETURNS 


widget 
The identifier of the created widget. 





ARGUMENTS 


parent_widget 
The identifier of the parent widget. 


name 
The name of the created widget. 


override_arglist 


The application override argument list. 


override_argcount 


The number of arguments in the application override argument list. 





WIDGET- 
SPECIFIC 
ATTRIBUTES 


default_horizontal_offset 
VAX binding: DWT$C_NDEFAULT_HORIZONTAL_OFFSET 
Chinding: DwtNdefaultHorizontalOffset 


The default horizontal offset for right and left attachments. The offset 
determines the amount of space between the left or right edge of a child 
widget and the edge or position to which it is attached. The default offset 
is zero. 


default_vertical_offset 
VAX binding: DWT$C_NDEFAULT_VERTICAL_OFFSET 
C binding: DwtNdefaultVerticalOffset 
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The default vertical offset for top and bottom attachments. The offset 
determines the amount of space between the top or bottom edge of a child 
widget and the edge or position to which it is attached. The default offset 
is zero. 


rubber_positioning 
VAX binding: DWT$C_NRUBBER_POSITIONING 
C binding: DwtNrubberPositioning 


A Boolean attribute that specifies the default attachments of child widget 
edges. If true, child widget edges default to being attached to themselves. 
If false, child widget left and top edges default to being attached to the left 
and top of the attached dialog box. The default is false. 


fraction_base 
VAX binding: DWT$C_NFRACTION_BASE 
C binding: DwtNfractionBase 


The denominator used in specifying fractional positioning. The default 
is 100. 





ATTRIBUTE 
EXCEPTIONS 


CONSTRAINT 
ATTRIBUTES 


None. Inherits all attributes of dialog box and its superclasses. 


The following constraint attributes belong to any widget made a child of an 
attached dialog box widget. These attributes cannot be set on the attached 
dialog box itself; they must be set on the child widget. 


adb_top_ attachment 
VAX binding: DWT$C_NADB_TOP_ATTACHMENT 
C binding: DwtNadbTopAttachment 


Specifies how the top edge of the child widget is attached to its parent 
attached dialog box widget, another child widget, a position, or itself. The 
predefined values for this attribute are as follows: 


VAX Cc Description 
DWT$C_ATTACH_NONE DwtAttachNone Do not attach this edge. 


This attachment can 
be overridden by other 
attachments. 


DWT$C_ATTACH_ADB DwtAttachAdb Attach the top edge of 
the child widget to the 
top edge of its parent 
attached dialog box. 


DWT$C_ATTACH_OPP_ADB DwtAttachOppAdb Attach the top edge of 
the child widget to the 
bottom edge of the parent 
attached dialog box. 


Low-Level Widget Routines 
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VAX Cc Description 


DWT$C_ATTACH_WIDGET DwtAttachWidget Attach the top edge of 
the child widget to the 
bottom edge of another 


child widget. 
DWT$C_ATTACH_OPP_. DwtAttachOppWidget Attach the top edge of 
WIDGET the child widget to the 

top edge of another child 

widget. 
DWT$C_ATTACH_POSITION DwtAitachPosition Attach the top edge of 


the child widget to a 
relative position inside the 
parent attached dialog 
box. See the description 
of the adb_top_position 
attribute. 


DWT$C_ATTACH_SELF DwtAttachSelf Attach the top edge of the 
. child widget to a relative 
position corresponding to 
the edge’s initial position 
in the attached dialog 
box. 


adb_top_ widget 
VAX binding: DWT$C_NADB_TOP_WIDGET 
C binding: DwtNadbTopWidget 


The child widget the top edge is attached to if adb_top_attachment is 
Attach Widget or Attach Opp Widget. This attribute is not used for other 
types of attachments. The default is null. 


adb_top position 
VAX binding: DWT$C_NADB_TOP_POSITION 
C binding: DwtNadbTopPosition 


The numerator used with fraction_base as denominator to determine 
the relative positioning of the top edge if adb_top_attachment is Attach 
Position. This attribute is not used for other types of attachments. The 
default is zero. 


adb_top_ offset 
VAX binding: DWT$C_NADB_TOP_OFFSET 
C binding: DwtNadbTopOffset 


The offset of the top edge from the position, widget, or attached dialog 
box. The default is the value specified with default_vertical_offset. If 
adb_top_attachment is Attach Position, one-half the offset value is used 
for placing the top edge. 


adb_bottom_attachment 
VAX binding: DWT$C_NADB_BOTTOM_ATTACHMENT 
C binding: DwtNadbBottomAttachment 
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Specifies how the bottom edge of the widget is attached to the edge of its 
parent attached dialog box widget, another child widget, a position, or 
itself. The predefined values for this attribute are as follows: 


VAX Cc Description 


DWT$C_ATTACH_NONE DwtAttachNone Do not attach this edge. 


This attachment can 

be overridden by other 

attachments. 
DWT$C_ATTACH_ADB DwtAttachAdb Attach this edge to the 

bottom edge of its parent 

attached dialog box. 


DWT$C_ATTACH_OPP_ADB DwtAttachOppAdb Attach this edge to the 
top edge of the parent 
attached dialog box. 


DWT$C_ATTACH_WIDGET DwiAttachWidget Attach this edge to the 
top edge of another child 
widget. 

DWT$C_ATTACH_OPP_ DwtAttachOppWidget Attach this edge to the 

WIDGET bottom edge of another 
child widget. 

DWT$C_ATTACH_POSITION DwtAttachPosition Attach this edge to a 


relative position inside the 
parent attached dialog 
box. See the description 
of the adb_bottom_ 
position attribute. 


DWT$C_ATTACH_SELF DwtAttachSelf Attach this edge to 
a relative position 
corresponding to the 
edge’s initial position in 
the parent attached dialog 
box. 


adb_bottom_widget 
VAX binding: DWT$C_NADB_BOTTOM_WIDGET 
C binding: DwtNadbBottomWidget 


The widget the bottom edge is attached to if adb_bottom_attachment is 
Attach Widget or Attach Opp Widget. This attribute is not used for other 
attachment types. The default is null. 


adb_bottom_position 
VAX binding: DWT$C_NADB_BOTTOM_POSITION 
C binding: DwtNadbBottomPosition 


The numerator used with fraction_base as denominator to determine 
the relative position of the bottom edge if adb_bottom_attachment is 
Attach Position. This attribute is not used for other attachment types. 
The default is zero. 
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adb_bottom_offset 
VAX binding: DWT$C_NADB_BOTTOM_OFFSET 
C binding: DwtNadbBottomOffset 


The offset of the bottom edge from the position, widget, or attached dialog 
box. The default is the value specified with default_vertical_offset. If 
adb_bottom_attachment is Attach Position, one-half the offset value is 
used to place the botton edge. 


adb_left_attachment 
VAX binding: DWT$C_NADB_LEFT_ATTACHMENT 
C binding: DwtNadbLeftAttachment 


Specifies how the left edge of the widget is attached to the edge of its 
parent attached dialog box widget, another child widget, a position, or 
itself. The predefined values for this attribute are as follows: 


VAX Cc Description 
DWT$C_ATTACH_NONE DwtAttachNone Do not attach this edge. 


This attachment can 
be overridden by other 
attachments. 


DWT$C_ATTACH_ADB DwtAttachAdb Attach this edge to the 
left edge of its parent 
attached dialog box. 


DWT$C_ATTACH_OPP_ADB DwtAttachOppAdb Attach this edge to the 
right edge of the parent 
attached dialog box. 


DWT$C_ATTACH_WIDGET DwtAttachWidget Attach this edge to the 
right edge of another 
child widget. 

DWT$C_ATTACH_OPP_ DwtAttachOppWidget Attach this edge to the 

WIDGET left edge of another child 
widget. 

DWT$C_ATTACH_POSITION DwtAttachPosition Attach this edge to a 


relative position inside the 
parent attached dialog 
box. See the description 
of the adb_left_position 
attribute. 


DWT$C_ATTACH_SELF DwtAttachSelf Attach this edge to 
a relative position 
corresponding to the 
edge’s initial position in 
the parent attached dialog 
box. 


adb_left_widget 
VAX binding: DWT$C_NADB_LEFT_WIDGET 
C binding: DwtNadbLeftWidget 


The widget the left edge is attached to if adb_left_attachment is 
Attach Widget or Attach Opp Widget. This attribute is not used for 
other attachment types. The default is null. 
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adb_left_position 
VAX binding: DWT$C_NADB_LEFT_POSITION 
C binding: DwtNadbLeftPosition 


The numerator used with fraction_base as denominator to determine 
the relative position of the left edge if adb_left_attachment is Attach 
Position. This attribute is not used for other attachment types. The 
default is zero. 


adb_left_offset 
VAX binding: DWT$C_NADB_LEFT_OFFSET 
C binding: DwtNadbLeftOffset 


The offset of the left edge from the position, widget, or attached dialog 
box. The default is the value specified with default_horizontal_offset. If 
adb_left_attachment is Attach Position, one-half the offset value is used 
to place the left edge. 


adb_right_atitachment 
VAX binding: DWT$C_NADB_RIGHT_ATTACHMENT 
C binding: DwtNadbRightAttachment 


Specifies how the right edge of the widget is attached to the edge of its 
parent attached dialog box widget, another child widget, a position, or 
itself. The predefined values for this attribute are as follows: 


VAX Cc Description 
DWT$C_ATTACH_NONE DwtAttachNone Do not attach this edge. 


This attachment can 
be overridden by other 
attachments. 


DWT$C_ATTACH_ADB DwtAttachAdb Attach this edge to the 
right edge of its parent 
attached dialog box. 


DWT$C_ATTACH_OPP_ADB DwtAttachOppAdb Attach this edge to the 
left edge of the parent 
attached dialog box. 


DWT$C_ATTACH_WIDGET DwtAttachWidget Attach this edge to the 
left edge of another child 
widget. 

DWT$C_ATTACH_OPP_ DwtAttachOppWidget Attach this edge to the 

WIDGET right edge of another 
child widget. 
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VAX Cc Description 


DWT$C_ATTACH_POSITION DwtAttachPosition Attach this edge to a 
relative position inside 
the parent attached 
dialog box. See the 
description of the adb_ 
right_position attribute. 


DWT$C_ATTACH_SELF DwtAttachSelf Attach this edge to 
a relative position 
corresponding to the 
edge’s initial position in 
the parent attached dialog 
box. 


adb_right_widget 
VAX binding: DWT$C_NADB_RIGHT_WIDGET 
Cbinding: DwtNadbRightWidget 


The widget the right edge is attached to if adb_right_attachment is 
Attach Widget or Attach Opp Widget. This attribute is not used for other 
attachment types. The default is null. 


adb_right_position 
VAX binding: DWT$C_NADB_RIGHT_POSITION 
C binding: DwtNadbRightPosition 


The numerator used with the fraction_base as denominator to determine 
the relative position of the right edge if adb_right_attachment is Attach 
Position. This attribute is not used for other attachment types. The 
default is zero. 


adb_right_offset 
VAX binding: DWT$C_NADB_RIGHT_OFFSET 
C binding: DwtNadbRightOffset 


The offset of the right edge from the position, widget, or attached dialog 
box. The default is the value specified with default_horizontal_offset. 
If adb_right_attachment is Attach Position, one-half the offset value is 
used to place the right edge. 








CALLBACK See the low-level routine DIALOG BOX CREATE. 
DATA 
STRUCTURE 
ATTACHED DIALOG BOX CREATE creates an attached dialog box widget 


DESCRIPTION 


to contain child widgets. The attached dialog box acts as a container only. 
It provides no input semantics over and above the semantics of the widgets 
that it contains. 


geometry 
management 
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The attached dialog box differs from the dialog box in its handling of 
child widgets. Constraints are placed on each child widget at the time 
of creation. The default values for the constraint attributes described 

in ATTACHED DIALOG BOX CREATE are placed on the child unless 
the programmer specifies values for the constraint attributes. Values are 


‘specified either in the override_arglist or by using the intrinsic routine 


SET VALUES. 


Using the constraint attributes, the application programmer can attach 
each of the four edges of a child widget (top, bottom, right, and left) to 

an edge of the parent attached dialog box, to an edge of another child 
widget, to a relative position within the attached dialog box, to itself, or to 
nothing. The possible attachments for each of the four edges are described 
in the Constraint Attributes section. Specifying these attachments allows 
the programmer to maintain the position of the child widgets within the 
attached dialog box as resizing occurs. 


In many cases the attachment changes the dimensions of the child widget. 


For all attachment types, the programmer can optionally specify an 
offset in pixels or font units. The offset determines the amount of space 
between the edge of the child widget and the edge or position to which it 
is attached. By default, child widgets are positioned in an attached dialog 
box in terms of font units rather than pixel units. (See the units attribute 
described in DIALOG BOX CREATE.) The x font units are defined to be 
one-fourth the width of whatever font is supplied for the common attribute 
font. The y font units are defined to be one-eighth the height of whatever 
font is supplied for the common attribute font. 


The offsets given are automatically negated when dealing with right and 
bottom edges. For example, an offset of 5 means that the edge stays 5 
units to the right of its attachment if a left edge, and 5 units to the left if 
a right edge. Offsets default to the value specified for the attached dialog 
box unless the attachment is Attach Position. In that case, the default 
offset is one-half the value specified. There are separate horizontal and 
vertical default offsets. 


The application programmer can determine whether the attached dialog 
box honors resize geometry requests from a given child widget by 
appropriately setting the resize attribute for that child. If it does honor 
a request, the attached dialog box reconfigures all child widgets based on 
current attachments of the child widgets. 


Child widgets can be added after the attached dialog box widget has been 
realized. If there is extra room in the attached dialog box, the new child 
widget is added. If there is not enough room, the attached dialog box 
requests permission to resize from the geometry manager. 


An attached dialog box widget can also be created with the high-level 
routine ATTACHED DIALOG BOX. 


The attached dialog box widget follows the same rules for geometry 
management as its superclass the dialog box widget, described in the 
low-level routine DIALOG BOX CREATE. 
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resizing The attached dialog box widget follows the same rules for resizing as 
its superclass the dialog box widget, described in the low-level routine 
DIALOG BOX CREATE. 
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ATTACHED DIALOG BOX POPUP CREATE 


Creates an attached pop-up dialog box widget. 





WIDGET CLASS 
HIERARCHY eee 
ee 
aah 
ais 


\ 
attached dialog box popup 





VAX FORMAT __ widget = DWT$ATTACH ED DB POPUP_CREATE 
(parent_widget, name, override_arglist, 
override_argcount) 


argument 

information Argument Usage Data Type Access Mechanism 
widget widget _ uns longword write value 
parent_widget widget uns longword read reference 
name char string char string read descriptor 
override_arglist arglist uns longword read reference 
override_argcount uns longword uns longword read reference 

attribute 

information The widget-specific attributes described in the low-level routine 


ATTACHED DIALOG BOX CREATE can be set in the override_arglist. 





MITC FORMAT widget = DwtAttachedDBPopupCreate 
(parent_widget, name, override_arglist, 
override_argcount) 
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argument 
information Widget DwtAttachedDBPopupCreate (parent _widget, name, 
override _arglist, 
override _argcount) 

Widget parent widget; 

char *name; 

ArgList override _arglist; 

int override _argcount; 
attribute The widget-specific attributes described in the low-level routine 
information ATTACHED DIALOG BOX CREATE can be set in the override_arglist. 
RETURNS widget 


The identifier of the created widget. 





ARGUMENTS _ parent_widget 
The identifier of the parent widget. 


name 
The name of the created widget. 


override_arglist 
The application override argument list. 


override_argcount 
The number of arguments in the application override argument list. 








WIDGET- See the widget-specific attributes for the low-level routine ATTACHED 
SPECIFIC DIALOG BOX CREATE. 

ATTRIBUTES 

ATTRIBUTE None. Inherits all attributes of dialog box and its superclasses. 
EXCEPTIONS 





CONSTRAINT See the constraint attributes described for the low-level routine 
ATTRIBUTES ATTACHED DIALOG BOX CREATE. 





CALLBACK See the low-level routine DIALOG BOX POPUP CREATE. 
DATA 
STRUCTURE 


DESCRIPTION ATTACHED DIALOG BOX POPUP CREATE creates an attached pop-up 
dialog box widget to contain child widgets. See the description of the 
low-level routine ATTACHED DIALOG BOX CREATE for details. 





? 
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geometry The attached pop-up dialog box widget follows the same rules for geometry 
management management as its superclass the dialog pop-up widget, described in the 


low-level routine DIALOG BOX POPUP CREATE. 


resizing The attached pop-up dialog box widget follows the same rules for resizing 
as its superclass the dialog box pop-up widget, described in the low-level 
routine DIALOG BOX POPUP CREATE. 
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CAUTION BOX CREATE 


Creates a caution box widget. 





WIDGET CLASS 
HIERARCHY pate 
anal 
ere 
ae 
ee box 





VAX FORMAT _ widget = DWT$CAUTION_BOX_CREATE 
(parent_widget, name, override_arglist, 
override_argcount) 


argument 

information Argument Usage Data Type Access Mechanism 
widget widget uns longword write value 
parent_widget widget uns longword read reference 
name char string char string read descriptor 
override_arglist arglist uns longword — read reference 
override_argcount —_ uns longword uns longword read reference 

attribute 

information The following widget-specific attributes can be set in the override_ 
arglist: 
Attribute Usage Data Type Access Mechanism 
label comp string uns longword read reference 
yes_label comp string uns longword read reference 
no_label comp string uns longword read reference 
cancel_label comp string uns longword read reference 
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Attribute Usage Data Type Access Mechanism 
default_push_button longword longword read value 
yes_callback callback uns longword read reference 
no_callback callback uns longword read reference 
cancel_callback callback uns longword read reference 





MIT C FORMAT 


argument 
information 


attribute 
information 


widget = DwtCautionBoxCreate 
(parent_widget, name, override_arglist, 
override_argcount) 


Widget DwtCautionBoxCreate (parent_widget, name, 
override arglist, override_argcount) 
Widget parent_widget; 
char *xname; 
ArgList override_arglist; 
int override argcount; 


The following widget-specific attributes can be set in the override_ 
arglist: 


DwtCompString label; 

DwtCompString yes label 
DwtCompString no_label; 
DwtCompString cancel label; 
unsigned char default _push_button; 
DwtCallbackPtr yes_callback; 
DwtCallbackPtr no _ callback; 
DwtCallbackPtr cancel_callback; 





RETURNS 


widget — 
The identifier of the created widget. 





ARGUMENTS 


parent_widget 
The identifier of the parent widget. 


name 
The name of the created widget. 


override_arglist 


The application override argument list. 


override_argcount 


The number of arguments in the application override argument list. 
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WIDGET- 
SPECIFIC 
ATTRIBUTES 
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label 
VAX binding: DWT$C_NLABEL 
C binding: DwtNlabel 


The text in the message line or lines. This attribute defaults to the widget 
name. 


yes label 
VAX binding: DWT$C_NYES_LABEL 
C binding: DwtNyesLabel 


The label for the Yes push button. If the label has zero length, the button 
is not displayed. The default is “Yes”. 


no_label 
VAX binding: DWT$C_NNO_LABEL 
C binding: DwtNnoLabel 


The label for the No push button. If the label has zero length, the button 
is not displayed. The default is “No”. 


cancel_label 
VAX binding: DWT$C_NCANCEL_LABEL 
C binding: DwtNecancelLabel 


The label for the Cancel push button. If the label is a zero-length string, 
the button is not displayed. The default is “Cancel”. 


default_push_button 
VAX binding: DWT$C_NDEFAULT_PUSH_BUTTON 
C binding: DwtNdefaultPushButton 


The push button that represents the default user action. The predefined 
values for this attribute are as follows: 


VAX Cc Description 
DWT$C_YES_BUTTON DwtYesButton Yes button (default) 
DWT$C_NO_BUTTON DwtNoButton No button 
DWT$C_CANCEL_BUTTON DwtCancelButton Cancel button 


yes_callback 
VAX binding: DWT$C_NYES_CALLBACK 
C binding: DwtNyesCallback 


The callback routine or routines called when the Yes button is activated. 
For this routine the callback reason is Yes. The default is null. 


no_callback 
VAX binding: DWT$C_NNO_CALLBACK 
C binding: DwtNnoCallback 


The callback routine or routines called when the No button is activated. 
For this routine the callback reason is No. The default is null. 


Low-Level Widget Routines 
CAUTION BOX CREATE 


cancel_callback 
VAX binding: DWT$C_NCANCEL_CALLBACK 
C binding: DwtNeancelCallback 


The callback routine or routines called when the Cancel button is 
activated. For this routine the callback reason is Cancel. The default 
is null. 





ATTRIBUTE 
EXCEPTIONS 


The following attributes described in the low-level routine DIALOG BOX 
POPUP CREATE are not supported: 


e cancel_button 

e child_overlap 

¢ default_button 

¢ text_merge_translation 

* units 

¢ direction_r_to_l 

The following attributes described in the low-level routine DIALOG BOX 
POPUP CREATE are supported differently by CAUTION BOX CREATE: 
e The default for margin_width is 12. 

e ©The default for margin_height is 10. 

e The default for resize is Shrink Wrap. 

e The default for style is Modal. 





CALLBACK 
DATA 
STRUCTURE 


VAX field 
information 


31 0 


reason 
event 


ZK-0091A-GE 


Structure name: DWT$ANY_CB_ST 


Name Usage Data Type Access Mechanism 


any_reason callback reason longword read value 
any_event event uns longword read reference 
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MIT C field 
information typedef struct { 
int reason; 
XEvent *event; 
} DwtAnyCallbackStruct; 





CALLBACK reason 


FIELD An integer set to the callback reason. See the Callback Reasons section for 
the values applicable to this widget. 

DESCRIPTIONS 
event 
A pointer to the X event structure describing the event that generated this 
callback. . 





CALLBACK yee ding: DWTSC_C 
inding: T RYES 
REASONS C binding: . DwtCRYes 


The user activated the Yes button. 
No 


VAX binding: DWT$C_CRNO 
C binding: DwtCRNo 


The user activated the No button. 


Cancel 
VAX binding: DWT$C_CRCANCEL 
C binding: DwtNCRCancel 


The user activated the Cancel button. 


Help Requested 
VAX binding: DWT$C_CRHELP_REQUESTED 
C binding: DwtCRHelpRequested 


The user selected help somewhere in the caution box. 





DESCRIPTION CAUTION BOX CREATE creates a caution box widget, a member of the 
message class of widgets. 


The caution box widget is a dialog box that allows the application to 
display caution messages to the user. The caution message warns the 
user of the consequences of carrying out an action. When style is Modal, 
execution of the application stops until the user provides input on how to 
proceed. The box can contain Yes, No, and Cancel push buttons. 


If style is Modal when the user activates any push button, the widget is 
cleared from the screen but not destroyed. The widget can be redisplayed 
using the intrinsic routine MANAGE CHILD. 


A caution box can also be created with the high-level routine CAUTION 
BOX. 


geometry 
management 


resizing 
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The caution box widget follows the same rules for geometry management 
as its superclass the dialog box widget, described in the low-level routine 
DIALOG BOX CREATE. 


The caution box widget follows the same rules for resizing as its superclass 
the dialog box widget, described in the low-level routine DIALOG BOX 
CREATE. 
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COMMAND WINDOW CREATE 


Creates a command window widget. 





WIDGET CLASS 
HIERARCHY Bia 
\ 
composite 
\ 
constraint 
\ 
dialog 
\ 


command window 





VAX FORMAT ~~ widget = DWT$COMMAND_WINDOW_CREATE 
(parent_widget, name, override_arglist, 
override_argcount) 


argument 

information Argument Usage Data Type Access Mechanism 
widget widget uns longword write value 
parent_widget widget uns longword read reference 
name char string char string read descriptor 
override_arglist arglist uns longword read reference 
override_argcount —_uns longword uns longword read reference 

attribute : 

information The following widget-specific attributes can be set in the override_ 
arglist: 
Attribute Usage Data Type Access Mechanism 
value char string char string read reference 
prompt comp string uns longword read reference 
lines uns longword uns longword read value 
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Attribute Usage Data Type Access Mechanism 
history char string char string read reference 
command_ callback uns longword read reference 
entered_callback 

value_changed_ callback uns longword read reference 
callback 

t_translation translations uns longword read reference 





MIT C FORMAT widget = DwtCommandWindowCreate 
(parent_widget, name, override_arglist, 
override_argcount) 





argument 
information Widget DwtCommandWindowCreate(parent_widget, name, 
override arglist, override _argcount) 
Widget parent _widget; 
char *name ; 
ArgList override arglist; 
int override argcount; 
attribute The following widget-specific attributes can be set in the override_ 
information arglist: 
char ‘value; 
DwtCompString prompt; 
int lines; 
char *history; 
DwtCallbackPtr command_entered callback; 
DwtCallbackPtr value_changed_callback; 
XtTranslations t_translation; 
RETURNS widget 


The identifier of the created widget. 





ARGUMENTS _ parent_widget 
The identifier of the parent widget. 


name 


The name of the created widget. 


override_arglist 


The application override argument list. 


override_argcount 


The number of arguments in the application override argument list. 
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WIDGET- value 
SPECIFIC VAX binding: DWT$C_NVALUE 


ATTRIBUTES C binding: DwtNvalue 


The current contents of the command line string. When a command- 
entered callback is made, this attribute is always null. The default is 
null. 


prompt 
VAX binding: DWT$C_NPROMPT 
C binding: DwtNprompt 


The command line prompt. The default is “>”. 


lines 
VAX binding: DWT$C_NLINES 
C binding: DwtNlines 


The number of command history lines visible in the command widget 
window. The default is 2 lines. 


history 
VAX binding: DWT$C_NHISTORY 
C binding: DwtNhistory 


The contents of the command line history. Multiple lines should be 
separated by a linefeed character. The default is the null string. 


command_entered_callback 
VAX binding: DWT$C_NCOMMOND_ENTERED_CALLBACK 
C binding; DwtNcommandEnteredCallback 


The callback routine or routines called when a command is executed. For 
this routine the callback reason is Command Entered. The default is 
null. 


value_changed_callback 
VAX binding: DWT$C_NVALUE_CHANGED_CALLBACK 
C binding: DwtNvalueChangedCallback 


The callback routine or routines called when the contents of the command 
line change. For this routine the callback reason is Value Changed. The 
default is null. 


t_ translation 
VAX binding: DWT$C_NT_TRANSLATION 
C binding: DwtNtTranslation 


Translations used for the command line text field. The default is null. See 
the VMS DECwindows Guide to Application Programming for information 
on translation tables. 





ATTRIBUTE The following attributes of the low-level routine DIALOG BOX are not 
EXCEPTIONS = ““PPorted: 


¢ child_overlap 


° resize 
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e text_merge_translation 

¢ units 

e direction_r_to_l 

The following attribute of the low-level routine DIALOG BOX CREATE is 
supported differently: 


¢ The default_position attribute is set to true. This causes the 
command window to be positioned in the bottom left corner of the 
parent widget. 








CALLBACK 
DATA 
STRUCTURE 
ZK-0252A-GE 
VAX field Structure name: DWT$COMWIN_CB ST 
information 
Name Usage Data Type Access Mechanism 
comwindow_reason callback longword read value 
reason 
comwindow_event event uns longword read reference 
comwindow_length longword longword read. value 
comwindow_value char string char string read reference 
MIT C field | 
information area iia 
anit reason; 
XEvent *event; 
int length; 
char *value; 


} DwtCommandWindowCallbackStruct; 





CALLBACK reason 
FIELD An integer set to the callback reason. See the Callback Reasons section for 


the values applicable to this widget. 
DESCRIPTIONS 
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event 

A pointer to the X event structure describing the event that generated this 
callback. For more information about X events, see the VMS DECwindows 
Xlib Routines Reference Manual. 


length 


The length of the current command line contents. 


value 


The current command line contents. 





CALLBACK 
REASONS 


Command Entered 
VAX binding: DWT$C_CRCOMMAND_ENTERED 
C binding; DwtCRCommandEntered 


A complete command line is ready to be executed. 


Value Changed 
VAX binding: DWT$C_CRVALUE_CHANGED 
C binding: DwtCRValueChanged 


The contents of the command line have changed. 


Focus 
VAX binding: DWT$C_CRFOCUS 
C binding: DwtCRFocus 


The command widget has received input focus. 


Help Requested 
VAX binding: DWT$C_CRHELP_REQUESTED 
C binding: DwtCRHelpRequested 


The user selected help in the command window. 





DESCRIPTION 


geometry 
management 


resizing 
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COMMAND WINDOW CREATE creates a command window widget. The 
command window widget handles command line entry, command line 
history, and command line recall. 


A command window widget can also be created with the high-level routine 
COMMAND WINDOW. 


The command window widget follows the same rules for geometry 
management as its superclass the dialog box widget, described in the 
low-level routine DIALOG BOX CREATE. 


The command window widget follows the same rules for resizing as 
its superclass the dialog box widget, described in the low-level routine 
DIALOG BOX CREATE. 


Low-Level Widget Routines 
DIALOG BOX CREATE 


DIALOG BOX CREATE 


Creates a dialog box widget. 





WIDGET CLASS 
HIERARCHY — 
ae 
Peers 
ae 





VAX FORMAT ~~ _— widget = DWT$DIALOG_BOX_CREATE 
(parent_widget, name, override_arglist, 
override_argcount) 





argument 
information Argument Usage Data Type Access Mechanism 
widget widget uns longword write value 
parent_widget widget uns longword read reference 
name char string char string read descriptor 
override_arglist arglist uns longword read reference 
override_argcount —_uns longword uns longword read reference 
attribute ee ; 
information The following widget-specific attributes can be set in the override_ 
arglist: 
Attribute Usage Data Type Access Mechanism 
units byte uns byte read value 
style byte uns byte read value 
focus_callback callback uns longword read reference 
text_merge_ translations uns longword read reference 
translations 
margin_width dimension uns word read value 
margin_height dimension uns word read value 
default_position Boolean uns byte read value 
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Attribute 


user_data 
child_overlap 
resize 
foreground 
highlight 
highlight_pixmap 
direction_r_to_| 
font 
grab_key_syms 


grab_merge_ 
translations 


help_callback 


Usage Data Type Access Mechanism 
longword uns longwood read value 
Boolean uns byte read value 
byte uns byte read value 
pixel. uns longword read value 
pixel uns longword read value 
pixmap uns longword read value 
Boolean uns longword read value 
font list uns longword read reference 
uns longword uns longword read reference 
translations uns longword read reference 
callback uns longword read reference 





widget = DwtDialogBoxCreate 


(parent_widget, name, override_arglist, 
override_argcount) 


MIT C FORMAT 

argument 

information 
Widget 
char 
ArgList 
int 

attribute 

information arglist: 


unsigned char 
unsigned char 
DwtCallbackPtr 
XtTranslations 
Dimension 
Dimension 
Boolean 

Opaque 

Boolean 
unsigned char 
Pixel 

Pixel 

Pixmap 

Boolean 
DwtFontList 
Keysym 
XtTranslations 
DwtCallbackPtr 
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*¥name; 


override arglist; 
override _argcount; 


units; 
style; 


Widget DwtDialogBoxCreate (parent_widget, name, override _arglist, 
override _argcount) 
parent_widget; 


The following widget-specific attributes can be set in the override_ 


focus_callback; 
text_merge_ translations; 
margin_width; 
margin_height; 
default_position; 

*xuser data; 
child_overlap; 

resize; 

foreground; 

highlight; 
highlight_pixmap; 
direction_r_to_1; 

font; 

*grab_key syms; 
grab_merge_ translations; 
help callback; 
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RETURNS 


widget 
The identifier of the created dialog box widget. 





ARGUMENTS 


parent_widget 
The identifier of the parent widget. 


name 


The name of the created widget. 


override_arglist 
The application override argument list. 


override_argcount 
The number of arguments in the application override argument list. 





WIDGET- 
SPECIFIC 
ATTRIBUTES 


units 
VAX binding: DWT$C_NUNITS 
C binding: DwtNunits 


The type of units for x and y attributes. This attribute cannot be changed 
after the widget is created. The predefined values for this attribute are as 
follows: 


VAX Cc Description 
DWT$C_PIXEL_UNITS DwiPixelUnits Pixel units 
DWT$C_FONT_UNITS DwtFontUnits Font units (default) 
style 


VAX binding: DWT$C_NSTYLE 
C binding: DwtNstyle 


The style of the widget. This attribute cannot be changed after the widget 
is created. The predefined value for this attribute is as follows: 


VAX Cc Description 
DWT$C_WORKAREA DwtWorkarea Work area (default) 


focus_callback 
VAX binding: DWT$C_NFOCUS_CALLBACK 
C binding: DwtNfocusCallback 


The callback routine or routines called when the dialog box has accepted 
the input focus. For this routine, the callback reason is Focus. The 
default is null. 
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text_merge_translations 
VAX binding: DWT$C_NTEXT_MERGE_TRANSLATIONS 
C binding: DwtNtextMergeTranslations 


The translation manager syntax to be merged with each text widget. Note 
that when text_merge_translations is changed existing widgets are 
unaffected. The new value for text_merge_translations acts only on 
widgets that are added after the dialog box is created. The default is null. 


See the VMS DECwindows Guide to Application Programming for 
information on translation tables. 


margin_width 
VAX binding: DWT$C_NMARGIN_WIDTH 
C binding; DwtNmarginWidth 


The number of pixels between the maximum right border of a child widget 
window and the dialog box. The default is 1 pixel. 


margin_height 
VAX binding: DWT$C_NMARGIN_HEIGHT 
Chbinding:: DwtNmarginHeight 


The number of pixels between the maximum bottom border of a child 
widget window and the dialog box. The default is 1 pixel. 


default_position 
VAX binding: DWT$C_NDEFAULT_POSITION 
C binding: DwtNdefaultPosition 


A Boolean attribute that, if true, causes the core attributes x and y to be 
ignored and forces the default widget position. The default widget position 
is centered in the parent window. If false, the specified x and y attributes 
are used to position the widget. The default is false. 


user_data 
VAX binding: DWT$C_NUSER_DATA 
C binding: DwtNuserData 


A longword in which the application can store any value. To retrieve the 
value, use the intrinsic routine GET VALUES. The default is null. 


child_overlap 
VAX binding: DWT$C_NCHILD_OVERLAP 
C binding: DwtNchildOverlap 


Controls whether the dialog box allows its children to overlap on geometry 
requests. If true, the dialog box allows geometry requests from its children 
that result in one child overlapping other children. If false, the dialog box 
disallows these geometry requests. The default is true. 


resize 
VAX binding: DWT$C_NRESIZE 
C binding: DwtNresize 


Controls how the dialog box resizes when its children are managed and 
unmanaged and on geometry requests. The predefined values for this 
attribute are as follows: . 
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VAX Cc Description 


DWT$C_RESIZE_FIXED DwtResizeFixed Dialog box does not 
change its size when 
children are added or 
deleted, or on geometry 
requests from its children. 


DWT$C_RESIZE_GROW_ DwtResizeGrowOnly Dialog box always 

ONLY attempts to expand as 
necessary when children 
are added or deleted or 
on geometry requests 
from its children. (default) 


DWT$C_RESIZE_SHRINK_ DwtResizeShrinkWrap Dialog box always 

WRAP attempts to expand or 
shrink to fit its current 
set of managed children 
as children are added or 
deleted or on geometry 
requests from its children. 


foreground 
VAX binding: DWT$C_NFOREGROUND 
C binding: DwtNforeground 


The color of gadget children in the widget window. The default is the 
default foreground color. 


highlight 
VAX binding: DWT$C_NHIGHLIGHT 
C binding: DwtNhighlight 


The color used for highlighting gadget children. The default is the default 
foreground color. 


highlight_pixmap 
VAX binding: DWT$C_NHIGHLIGHT_PIXMAP 
C binding: DwtNhighlightPixmap 


The pattern and color used for highlighting gadget children. The default is 
null. 


direction _r_to_| 
VAX binding: DWT$C_NDIRECTION_R_TO_L 
C binding: DwtNdirectionRToL 


This attribute defines the predominant reading direction, but is not 
currently used by dialog box. 


font 
VAX binding: DWT$C_NFONT 
C binding: DwtNfont 


The font of the text used in gadget children. The default is the default 
XUI Toolkit font. 
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gtrab_key_syms 
VAX binding: DWT$C_NGRAB_KEY_SYMS 
C binding: DwtNgrabKeySyms 


A null-terminated array of key symbols. The default array contains the 
Tab key symbol. The dialog box calls an Xlib routine GRAB KEY for 
each key symbol. GRAB KEY specifies Any Modifier for modifiers, Grab 
Mode Async for pointer_mode, and Grab Mode Sync for keyboard_ 
mode. The GRAB KEY routine works in conjunction with the value of the 
grab_merge_translations attribute to implement moving the input focus 
among the dialog box children in a synchronous manner. See the VMS 
DECwindows Xlib Routines Reference Manual for more information about 
GRAB KEY. 


This attribute cannot be changed after the widget is created. 


grab_merge_translations 
VAX binding: DWT$C_NGRAB_MERGE_TRANSLATIONS 
C binding: DwtNgrabMergeTranslations 


The parsed translation syntax to merge into the dialog box syntax to 
handle the key events. The syntax is merged when the dialog box is first 
realized. Any change made to this attribute after the dialog box is realized 
will not have any effect. See the VMS DECwindows Guide to Application 
Programming for information on translation tables. 


The default syntax is as follows: 


"~Shift<cKeyPress>Oxff09: DWTDIMOVEFOCUSNEXT()\n\ 
Shift<KeyPress>Oxff09: DWTDIMOVEFOCUSPREV()"; 


help_callback 
VAX binding: DWT$C_NHELP_CALLBACK 
C binding: DwtNhelpCallback 


The callback routine or routines called when a user requests help. The 
default is null. 





ATTRIBUTE 
EXCEPTIONS 


CONSTRAINT 
ATTRIBUTES 


None. 


The following constraint attributes are passed on to any widget that is 
made a child of a dialog box widget. These constraint attributes are only 
used for dialog boxes that have the units attribute set to Font Units. 


font_x 
The placement of the left side of the widget window in font units. The 
default is the value of the core widget attribute x. 


font_y 
The placement of the top of the widget window in font units. The default 
is the value of the core widget attribute y. 
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CALLBACK 
DATA 31 0 
STRUCTURE [wasn 
ZK-0091A-GE 
VAX field Structure name: DWT$ANY_CB_ST 
information 
Name Usage Data Type Access Mechanism 
any_reason callback reason longword read value 
any_event event - uns longword read reference 
MIT C field 
information RSE ee 
int reason; 
XEvent *event; 
} DwtAnyCallbackStruct; 
CALLBACK reason 
FIELD An integer set to the callback reason. See the Callback Reasons section for 
the values applicable to this widget. 
DESCRIPTIONS 
event 
A pointer to the X event structure describing the event that generated this 
callback. 
CALLBACK Focus ‘ 
VAX binding: DWT$C_CRFOCUS 
REASONS C binding: DwtCRFocus 
The dialog box has received input focus. 
Help Requested 
VAX binding: DWT$C_CRHELP_REQUESTED 
C binding: DwtCRHelpRequested 
The user selected help. 
DESCRIPTION DIALOG BOX CREATE creates a dialog box widget. 


The dialog box widget is a composite widget that contains child widgets. 
Each child widget displays information or requests and handles input 
from the user. The dialog box widget functions as a container only. It 
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geometry 
management 


resizing 


provides no input semantics over and above the expressions of the widgets 
it contains. 


Child widgets can be positioned within the dialog box in two ways. By 
default, the child widgets are positioned in terms of font units (the default 
for units). The x font units are defined to be one-fourth the width of 
whatever font is supplied for the common attribute font. The y font units 
are defined to be one-eighth the height of whatever font is supplied for the 
common attribute font. Child widgets can also be positioned in terms of 
pixel units when units is defined as pixel units. 


A dialog box widget can also be created with the high-level routine 
DIALOG BOX. 


The dialog box widget is a generic container that treats all of its children 
equally in terms of geometry management. When a child is first added 
to a dialog box, it is placed using the x, y, width, height, and border_ 
width core attributes specified in the widget. The dialog box does not 
override any of the geometry of its children. The value of the child_ 
overlap attribute affects how the geometry manager reacts to geometry 
requests from its children. If the value of child_overlap is true (the 
default), then the dialog box allows a request from a child widget, even if 
the request results in the child widget overlapping another child widget 
in the dialog box. If the value of child_overlap is false, the dialog box 
geometry manager disallows such requests. 


The resizing behavior of the dialog box widget is controlled by the resize 
attribute. See the description for that attribute. 
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DIALOG BOX POPUP CREATE 


Creates a pop-up dialog box widget. 





WIDGET CLASS 
HIERARCHY Que 
— 
sera 
dialog 





VAX FORMAT __ widget = DWT$DIALOG_BOX_POPUP_CREATE 
(parent_widget, name, override_arglist, 
override_argcount) 





argument 

information Argument Usage Data Type Access Mechanism 
widget widget uns longword write value 
parent_widget widget uns longword read reference 
name ' char string char string read descriptor 
override_arglist arglist uns longword read reference 
override_argcount —_ uns longword uns longword read reference 

attribute | ; 

information The following widget-specific attributes can be set in the override_ 
arglist: 
Attribute Usage Data Type Access Mechanism 
units byte uns byte read value 
title comp string uns longword read reference 
style byte uns byte read value 
map_callback callback uns longword read reference 
unmap_cailback callback uns longword read reference 
focus_callback callback uns longword read reference 
text_merge_ translations uns longword read reference 


translations 
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MIT C FORMAT 


argument 
information 


attribute 
information 


Attribute 


margin_width 
margin_height 
default_position 
user_data 
child_overlap 
resize 
take_focus 
no_resize 
auto_unmanage 
default_button 
cancel_button 
foreground 
highlight 
highlight_pixmap 
direction_r_to_| 
font 
grab_key_syms 


grab_merge_ 
translations 


help_callback 


Usage Data Type Access Mechanism 
dimension uns word read value 
dimension uns word read value 
Boolean uns byte read value 
longword uns longword read value 
Boolean uns byte read value 
byte uns byte read value 
Boolean uns byte read value 
Boolean uns byte read value 
Boolean uns byte read value 
identifier uns longword read value 
identifier uns longword read value 
pixel uns longword read value 
pixel uns longword read value 
pixmap uns longword read value 
Boolean uns longword read value 
font list uns longword read reference 
uns longword —_ uns longword read reference 
translations uns longword read reference 
callback uns longword read reference 


widget = DwtDialogBoxPopupCreate 
(parent_widget, name, override_arglist, 
override_argcount) 


Widget DwtDialogBoxPopupCreate (parent_widget, name, 


Widget 
char 
ArgList 
int 


override arglist, 
override _argcount) 
parent widget; 
*name; 
override arglist; 
override argcount; 


The following widget-specific attributes can be set in the override_ 


arglist: 
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unsigned char units; 
DwtCompString title; 
unsigned char style; 
DwtCallbackPtr map_callback; 
DwtCallbackPtr unmap_callback; 
DwtCallbackPtr focus_callback; 
XtTranslations text_merge_ translations; 
Dimension margin_width; 
Dimension margin_height; 
Boolean default_position; 
Opaque *user data; 
Boolean child_overlap; 
unsigned char resize; 
Boolean take focus; 
Boolean no_resize; 
Boolean auto_unmanage; 
Widget default_button; 
Widget cancel button; 
Pixel foreground; 
Pixel highlight; 
Pixmap highlight_pixmap; 
Boolean direction_r_to_l; 
DwtFontList font; 
KeySym *grab_key syms; 
XtTranslations grab_merge translations; 
DwtCallbackPtr help callback; 
RETURNS widget 
The identifier of the created widget. 
ARGUMENTS _ parent_widget 
The identifier of the parent widget. 
name 
The name of the created widget. 
override_arglist 
The application override argument list. 
override_argcount 
The number of arguments in the application override argument list. 
WIDGET- units 
SPECIFIC VAX binding: DWT$C_NUNITS 
ATTRIBUTES C binding: DwtNunits 


The type of x and y units used when adding child widgets to the dialog 
box. This attribute cannot be changed after the widget is created. The 
predefined values for this attribute are as follows: 


VAX 


DWT$C_PIXEL_UNITS 
DWT$C_FONT_UNITS 


Cc Description 
DwtPixelUnits Pixel Units 
DwtFontUnits Font Units (default) 
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title 
VAX binding: DWT$C_NTITLE 
C binding: DwtNtitle 


The text label for the title bar when style is Modeless. The default text 
label is the widget name. When style is Modal, no title bar appears. 


style 
VAX binding: DWT$C_NSTYLE 
C binding: DwtNstyle 


The style of the widget. This attribute cannot be changed after the widget 
is created. One of the following predefined values for this attribute must 
be specified in the argument list: 


VAX Cc Description 

DWT$C_MODAL DwtModal Modal type box 

DWT$C_MODELESS DwtModeless Modeless type box 
(default) 


map_callback 
VAX binding: DWT$C_NMAP_CALLBACK 
C binding: DwtNmapCallback 


The callback routine or routines called when the window is about to be 
mapped. For this routine, the callback reason is Map. The default is null. 


unmap_callback 
VAX binding: DWT$C_NUNMAP_CALLBACK 
C binding: DwtNunmapCallback 


The callback routine or routines called when the window is unmapped. 
For this routine, the callback reason is Unmap. The default is null. 


focus_callback 
VAX binding: DWT$C_NFOCUS_CALLBACK 
C binding: DwtNfocusCallback 


The callback routine or routines when the dialog box has accepted the 
input focus. For this routine, the callback reason is Focus. The default is 
null. 


text_merge_translations 
VAX binding: DWT$C_NTEXT_MERGE_TRANSLATIONS 
C binding: DwtNtextMergeTranslations 


The translation manager syntax to be merged with each text widget. Note 
that when text_merge_translations is changed, existing widgets are 
unaffected. The new value for text_merge_translations acts only on 
widgets that are added after the pop-up dialog box is created. See the 
VMS DECwindows Guide to Application Programming for information on 
translation tables. The default is null. 
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margin_width 
VAX binding: DWT$C_NMARGIN_WIDTH 
C binding: DwtNmarginWidth 


The number of pixels between the maximum right border of a child widget 
window and the dialog box. The default is 3 pixels. 


margin_height 
VAX binding: DWT$C_NMARGIN_HEIGHT 
C binding: DwtNmarginHeight 


The number of pixels between the maximum bottom border of a child 
widget window and the dialog box. The default is 3 pixels. 


default_position 
VAX binding: DWT$C_NDEFAULT_POSITION 
C binding: DwtNdefaultPosition 


A Boolean attribute that, if true, causes the core attributes x and y to be 
ignored and forces the default widget position. The default widget position 
is centered in the parent window. If false, the specified x and y attributes 
are used to position the widget. The default is false. 


user_data 
VAX binding: DWT$C_NUSER_DATA 
C binding: DwtNuserData 


A longword in which the application can store any value. To retrieve the 
value, use the intrinsic routine GET VALUES. The default is null. 


child_overlap 
VAX binding: DWT$C_NCHILD_OVERLAP 
C binding: DwtNchildOverlap 


Controls whether the dialog box allows its children to overlap on geometry 
requests. If true, the dialog box allows geometry requests from its children 
that result in one child overlapping other children. If false, the dialog box 
disallows these geometry requests. The default is true. 


resize | 
VAX binding: DWT$C_NRESIZE 
C binding: DwtNresize 


Controls how the dialog box resizes when its children are managed and 
unmanaged and on geometry requests. The predefined values for this 
attribute are as follows: 


VAX Cc Description 


DWT$C_RESIZE_FIXED DwtResizeFixed Dialog box does not 
change its size when 
children are added or 
deleted or on geometry 
requests from its children. 
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VAX Cc Description 
DWT$C_RESIZE_GROW__ DwtResizeGrowOnly Dialog box always 
ONLY attempts to expand as 


necessary when children 
are added or deleted, or 
on geometry requests 
from its children. (default) 


DWT$C_RESIZE_SHRINK_ DwtResizeShrinkWrap Dialog box always 

WRAP attempts to expand or 
shrink to fit its current 
set of managed children 
as children are added or 
deleted or on geometry 
requests from its children. 


take_focus 
VAX binding: DWT$C_NTAKE_FOCUS 
C binding: DwtNtakeFocus 


A Boolean attribute that specifies whether the dialog box takes the input 
focus when managed. If true, the dialog box takes the input focus when 
managed. The default is true for a modal dialog box and false for a 
modeless dialog box. 


no_resize 
VAX binding: DWT$C_NNO_RESIZE 
C binding: DwtNnoResize 


A Boolean attribute that controls whether or not a modeless dialog box 
has a window manager resize button. When true, the dialog box has no 
button. When false, the dialog box has a button. The default is true. 


auto_unmanage 
VAX binding: DWT$C_NAUTO_UNMANAGE 
C binding: DwtNautoUnmanage 


A Boolean attribute that specifies whether a dialog box unmanages itself 
when any push button is activated. This attribute applies only to modal 
dialog boxes. If true, the dialog box unmanages itself when any push 
button is activated. This attribute cannot be changed after the widget is 
created. The default is true. 


default_button 
VAX binding: DWT$C_NDEFAULT_BUTTON 
C binding: DwtNdefaultButton 


The identifier of the push button that is activated when the [Return] or 
key is pressed. The default is null. 


cancel_button 
VAX binding: DWT$C_NCANCEL_BUTTON 
C binding: DwtNeancelButton 


The identifier of the push button that is activated when the [ Shif/Return | 
keys are pressed. The default is null. 
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foreground 
VAX binding: DWT$C_NFOREGROUND 
C binding: DwtNforeground 


The color of foreground objects in the widget window. The default is the 
default foreground color. 


highlight 
VAX binding: DWT$C_NHIGHLIGHT 
C binding: DwtNhighlight 


The color used for highlighting gadget children. The default is the default 
foreground color. 


highlight_pixmap 
VAX binding: DWT$C_NHIGHLIGHT_PIXMAP 
C binding: DwtNhighlightPixmap 


The pattern and color used for highlighting gadget children. The default is 
null. 


direction_r_to_l 
VAX binding: DWT$C_NDIRECTION_R_TO_L 
C binding: DwtNdirectionRToL 


This attribute defines the predominant reading direction, but it is not 
currently used by dialog box. 


font 
VAX binding: DWT$C_NFONT 
C binding: DwtNfont 


The font of the text used in gadget children. The default is the default 
XUI Toolkit font. 


gtab_key_syms 
VAX binding: DWT$C_NGRAB_KEY_SYMS 
C binding: DwtNgrabKeySyms 


A null-terminated array of key symbols. The default array contains the 
Tab key symbol. The dialog box calls an Xlib routine GRAB KEY for 
each key symbol. GRAB KEY specifies Any Modifier for modifiers, Grab 
Mode Async for pointer_mode, and Grab Mode Sync for keyboard_ 
mode. The GRAB KEY routine works in conjunction with the value of the 
grab_merge_translations attribute to implement moving the input focus 
among the dialog box children in a synchronous manner. See the VMS 
DECwindows Xlib Routines Reference Manual for more information about 
GRAB KEY. . 


This attribute cannot be changed after the widget is created. 
grab_merge_translations 


VAX binding: DWT$C_NGRAB_MERGE_TRANSLATIONS 
Cbinding:: DwtNgrabMergeTranslations 


The parsed translation syntax to merge into the dialog box syntax to 
handle the key events. The syntax is merged when the dialog box is first 
realized. Any change made to this attribute after the dialog box is realized 
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will not have any effect. See the VMS DECwindows Guide to Application 
Programming for information on translation tables. 


The default syntax is as follows: 
"~Shift<KeyPress>Oxff09: DWTDIMOVEFOCUSNEXT()\n\ 
Shift<KeyPress>Oxff09: DWTDIMOVEFOCUSPREV()"; 


help_callback 
VAX binding: DWT$C_NHELP_CALLBACK 
C binding: DwtNhelpCallback 


The callback routine or routines called when a user requests help. 








ATTRIBUTE None. 
EXCEPTIONS 
CONSTRAINT The following constraint attributes are passed on to any widget made a 
child of a dialog box widget. These constraint attributes are only used for 
ATTRIBUTES dialog boxes that have the units attribute set to font units. 
font_x 
The placement of the left side of the widget window in font units. The 
default is the value of the core widget attribute x. 
font_ 
The placement of the top of the widget window in font units. The default 
is the value of the core widget attribute y. 
CALLBACK 
DATA 31 | 0 
STRUCTURE 
ZK-0091A-GE 
VAX field Structure name: DWT$ANY_CB_ST 
information 
Name Usage Data Type Access Mechanism 
any_reason callback reason longword read ‘value 
any_event event uns longword read reference 
MIT C field 
information Rypege revue | 


int reason; 
XEvent *event; 
} DwtAnyCallbackStruct; 


Low-Level Widget Routines 
DIALOG BOX POPUP CREATE 





CALLBACK 
FIELD 
DESCRIPTIONS 


reason 
An integer set to the callback reason. See the Callback Reasons section for 
the values applicable to this widget. 


event 
A pointer to the X event structure describing the event that generated this 
callback. 





CALLBACK 
REASONS 


Map 
VAX binding: DWT$C_CRMAP 
C binding: DwtCRMap 


The dialog box is about to be mapped. 


Unmap 
VAX binding: DWT$C_CRUNMAP 
C binding: DwtCRUnmap 


The dialog box was just unmapped. 


Focus — 
VAX binding: DWT$C_CRFOCUS 
Chbinding: DwtCRFocus 


The dialog box has received input focus. 


Help Requested 
VAX binding: DWT$C_CRHELP_REQUESTED 
C binding: DwtCRHelpRequested 


The user selected help. 





DESCRIPTION 


geometry 
management 


resizing 


DIALOG BOX POPUP CREATE creates a pop-up dialog box widget. 


A pop-up dialog box widget can also be created with the high-level routine 
DIALOG BOX 


The pop-up dialog box widget follows the same rules for geometry 
management as the dialog widget, described in the low-level routine 
DIALOG BOX CREATE. 


The pop-up dialog box widget follows the same rules for resizing as 
the dialog box widget, described in the low-level routine DIALOG BOX 
CREATE. 
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FILE SELECTION CREATE 


Creates a file selection widget. 





WIDGET CLASS 
HIERARCHY bite 
\ 
composite 
\ 
constraint 
\ 
dialog 
\ 
selection 
\ 
file selection 





VAX FORMAT ~~ widget = DWT$FILE_SELECTION_CREATE 
(parent_widget, name, override_arglist, 
override_argcount) 


argument 

information Argument Usage Data Type Access Mechanism 
widget widget uns longword write value 
parent_widget widget uns longword read reference 
name char string char string read descriptor 
override_arglist arglist uns longword read reference 
override_argcount — uns longword uns longword read reference 

attribute ; 

information The following widget-specific attributes can be set in the override_ 
arglist: 
Attribute Usage Data Type Access Mechanism 
filter_label comp string uns longword read reference 
apply_label comp string uns longword read reference 
dir_mask comp string uns longword read reference 
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Attribute Usage Data Type Access Mechanism 
dir_spec comp string uns longword read reference 
file_search_proc void proc procedure entry read value 

mask 
list_updated Boolean uns byte read value 





MIT C FORMAT 


argument 
information 


widget = DwtFileSelectionCreate 
(parent_widget, name, override_arglist, 
override_argcount) 


Widget DwtFileSelectionCreate(parent_widget, name, 
override arglist, 
override argcount) 


Widget parent widget; 
char *name; 

ArgList override_arglist; 
int override _argcount; 








attribute The following widget-specific attributes can be set in the override_ 
information arglist: 
DwtCompString filter_label; 
DwtCompString apply label; 
DwtCompString dir_mask; 
DwtCompString dir _spec; 
VoidProc file search_proc; 
Boolean list_updated; 
RETURNS widget 
The identifier of the created widget. 
ARGUMENTS _parent_widget 


The identifier of the parent widget. 


name 
The name of the created widget. 


override_arglist 


The application override argument list. 


override_argcount 


The number of arguments in the application override argument list. 
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WIDGET- 
SPECIFIC 
ATTRIBUTES 
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filter_label 
VAX binding: DWT$C_NFILTER_LABEL 
C binding: DwtNfilterLabel 


The label for the search filter located above the text-entry field. The 
default is “File filter”. 


apply_label 
VAX binding: DWT$C_NAPPLY_LABEL 
C binding: DwtNapplyLabel 


The label for the Apply push button, which activates new file searches. 
The default is “Filter”. 


dir_mask 
VAX binding: DWT$C_NDIR_MASK 
C binding: DwtNdirMask 


The directory mask used in determining the files displayed in the file 
selection list box. The default is “*.*”. 


dir_spec 
VAX binding: DWT$C_NDIR_SPEC 
C binding: DwtNdirSpec 


The full VMS file specification. This field is write only and cannot be 
modified using the intrinsic routine SET VALUES. The default is the null 
string. 


file_search_proc 
VAX binding: DWT$C_NFILE_SEARCH_PROC 
C binding: DwtNfileSearchProc 


A directory search procedure to replace the default file selection search 
procedure. The file selection widget’s default file search procedure 

is written to fill the needs of most applications. However, since it is 
impossible to cover the requirements of all applications, the default search 
procedure can be replaced. 


The file_search_proc is called with two arguments: one argument is the 
file selection widget; the other argument is the file selection callback 
structure. The callback structure contains all required information 

to conduct a directory search, including the current file search mask. 
Once called, it is up to the search routine to generate a new list of files 
and update the file selection widget by using the intrinsic routine SET 
VALUES. The following attributes must be set: 


¢ items 


VAX binding: DWT$C_NITEMS 
C binding: DwtNitems 
Sets the item attribute described in the low-level routine SELECTION 


CREATE. Set the attribute to the new list of files. If there are no files, 
set the attribute to null. 


e¢ items_count 


VAX binding: DWT$C_NITEMS_COUNT 
C binding: DwtNitemsCount 
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Sets the items_count attribute described in the low-level routine 
SELECTION CREATE. If there are no files, set items_count to zero. 


e list_updated 


Always set the list_updated attribute to true when updating the file 
list through a search procedure, even if there are no files. The default 
is false. 


Setting the following field is optional, but recommended: 
¢ dir_spec 


Set to the full file specification of the directory searched. The directory 
specification is displayed above the list box. 


The default is the default file selection search procedure. 


list_updated 
VAX binding: DWT$C_NLIST_UPDATED 
C binding: DwtNlistUpdated 


Set true, if the file list has been updated. This argument is set only by the 
file search procedure. 





ATTRIBUTE 


EXCEPTIONS 


The default for selection_label (located above the list box) is “Files in”. 





CALLBACK 
DATA 
STRUCTURE 


VAX field 
information 


31 0 













ZK-0092A-GE 
Structure name: DWT$FILSEL_CB_ST 
Name Usage Data Type Access Mechanism 
filsel_reason callback — longword read value 
reason 
filsel_event event uns longword read reference 
filsel_value comp string uns longword read reference 
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MIT C field 
information 


Name Usage Data Type Access Mechanism 
filsel_value_len longword longword read value 
filsel_dirmask comp string uns longword read reference 
filsel_dirmask_len longword longword read value 


typedef struct { 


int reason; 
XEvent *event; 
DwtCompString value; 

int value_len 
DwtCompString dirmask; 
nbs dirmask_len 


} DwtFileSelectionCallbackStruct; 








CALLBACK reason | 
FIELD An integer set to the callback reason. See the Callback Reasons section for 
the values applicable to this widget. 
DESCRIPTIONS 
event 
A pointer to the X event structure describing the event that generated this 
callback. 
value 
The current selection when the callback occurred. 
value_len 
The length of the selection compound string. 
dirmask 
The current directory mask when the callback occurred. 
dirmask_len 
The length of the directory mask compound string. 
CALLBACK Activated 
REASONS VAX binding: DWT$C_CRACTIVATED 
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C binding: DwtCRActivated 
The user activated the OK push button. 


Cancel 
VAX binding: DWT$C_CRCANCEL 
C binding: DwtCRCancel 


The user activated the Cancel button. 


Help Requested 
VAX binding: DWT$C_CRHELP_REQUESTED 
C binding: DwtCRHelpRequested 


The user selected help somewhere in the file selection box. 
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DESCRIPTION 


geometry 
management 


resizing 


This routine creates a file selection widget for the application to query the 
user for a file selection. This is a subclass of the selection widget, which is 
a subclass of the dialog widget. The file selection widget is a specialized 
pop-up dialog box, supporting either modal or modeless formats. 


The file selection widget includes the following: 

e¢ A list box displaying the file names from which to choose 
e <A directory mask text entry field 

e A selection text entry field 


¢ An Apply push button to apply the directory mask, which generates a 
new list of files 


¢ An OK push button to inform the application that a selection has been 
made 


e A Cancel push button to inform the application that a selection has 
been canceled 


Note that the callback data structure also includes the current values 
of the value and dirmask attributes. This allows user input text and 
directory information to be passed back to the application. 


The file selection widget supports remote file searches between nodes 
on a network. Users can also perform remote file searches from VMS to 
ULTRIX systems, but currently not from ULTRIX to VMS systems. 


The file selection widget follows the same rules for geometry management 
as its superclass the selection widget, described in the low-level routine 
SELECTION CREATE. 


The file selection widget follows the same rules for resizing as its 
superclass the selection widget, described in the low-level routine 
SELECTION CREATE. 
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HELP CREATE 


Creates a help widget. 





WIDGET CLASS 
HIERARCHY — 


\ 
composite 
\ 
common 
‘ 
help 





VAX FORMAT ~~ widget = DWT$HELP_CREATE 
(parent_widget, name, override_arglist, 
override_argcount) 


argument 

information Argument Usage Data Type Access Mechanism 
widget widget longword write value 
parent_widget widget uns longword read reference 
name char string char string read descriptor 
override_arglist arglist uns longword read reference 
override_argcount — uns longword uns longword read reference 

attribute The following widget-specific attributes can be set in the override_ 

information arglist: 
Argument Usage Data Type Access Mechanism 
about_label comp string uns longword read reference 
add_topic_label comp string uns longword read reference 
application_name comp string uns longword read reference 
badframe_ comp string uns longword read reference 
message 
badlib_message comp string uns longword read reference 
cols uns longword uns longword read value 
copy_label comp string uns longword read reference 
default_position Boolean uns byte read value 
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Argument 


dismiss_label 
edit_label 


erroropen_ 
message 


exit_label 
file_label 
first_topic 
glossary_label 
glossary_topic 
goback_label 
goover_label 
goto_label 
help_font 
help_label 
helpmessage_title 
helpmessage_title_ 
type 

history_label 
historybox_label 
keyword_label 
keywords_label 
library_spec 
library_type 


nokeyword_ 
message 


notitle_ message 
nulllib_ message 
nulltopic_message 
overview_topic 
rows 

saveaslabel 
searchapply_label 


searchkeywordbox_ 


label 
search_label 


searchtitlebox_ 
label 


selectall_label 
title_label 
titles label 


Usage 


comp string 
comp string 
comp string 


comp string 
comp string 
comp string 
comp string 
comp string 
comp string 
comp string 
comp string 
font list 
comp string 
comp string 
uns longword 


comp string 
comp string 
comp string 
comp string 
comp string 
uns longword 
comp string 


comp string 
comp string 
comp string 
comp string 
uns longword 
comp string 
comp string 
comp string 


comp string 
comp string 


comp string 
comp string 
comp string 
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Data Type 


uns longword 
uns longword 
uns longword 


uns longword 
uns longword 
uns longword 
uns longword 
uns longword 
uns longword 
uns longword 
uns longword 
uns longword 
uns longword 
uns longword 
uns longword 


uns longword 
uns longword 
uns longword 
uns longword 
uns longword 
uns longword 
uns longword 


uns longword 
uns longword 
uns longword 
uns longword 
uns longword 
uns longword 
uns longword 
uns longword 


uns longword 
uns longword 


uns longword 
uns longword 
uns longword 


Access 


read 
read 
read 


read 
read 
read 
read 
read 
read 
read 
read 
read 
read 
read 
read 


read 
read 
read 
read 
read 
read 
read 


read 
read 
read 
read 
read 
read 
read 
read 


read 
read 


read 
read 
read 


Mechanism 


reference 
reference 
reference 


reference 
reference 
reference 
reference 
reference 
reference 
reference 
reference 
reference 
reference 
reference 
value 


reference 
reference 
reference 
reference 
reference 
value 

reference 


reference 
reference 
reference 
reference 
value 

reference 
reference 
reference 


reference 
reference 


reference 
reference 
reference 
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Argument 


topictitles_label 
view_label 
visitglos_label 
visit_label 
unmap_callback 


Usage Data Type Access Mechanism 
comp string uns longword read reference 
comp string uns longword read reference 
comp string uns longword read reference 
comp string uns longword read reference 
callback uns longword read reference 








MIT C FORMAT 


widget = DwtHelpCreate 


(parent_widget, name, override_arglist, 
override_argcount) 


argument 
information 


Widget 
char 
Arghlist 
int 


attribute 


information arglist: 


DwtCompString 
DwtCompString 
DwtCompString 
DwtCompString 
DwtCompString 
int 
DwtCompString 
Boolean 
DwtCompString 
DwtCompString 
DwtCompString 
DwtCompString 
DwtCompString 
DwtCompString 
DwtCompString 
DwtCompString 
DwtCompString 
DwtCompString 
DwtCompString 
DwtFontList 
DwtCompString 
DwtCompString 
unsigned char 
DwtCompString 
DwtCompString 
DwtCompString 
DwtCompString 
DwtCompString 
unsigned int 
DwtCompString 
DwtCompString 
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override _argcount) 


parent widget; 


*Aname; 


override arglist; 
override _argcount; 


Widget DwtHelpCreate(parent_widget, name, override _arglist, 


The following widget-specific attributes can be set in the override_ 


about _label; 
add_topic_ label; 
application_name; 
badframe_message; 
badlib message; 
cols; 

copy_label; 
default position; 
dismiss label; 
edit_label; 
erroropen_message; 
exit_label; 

file label; 

first topic; 
glossary label; 
glossary topic; 
goback_label; 
goover_ label; 
goto_label; 

help font; 

help label; 
helpmessage title; 
helpmessage title type; 
history label; 
historybox_label; 
keyword_label; 
keywords label; 
library spec; 
library type; 
nokeyword message; 
notitle_message; 
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DwtCompString nulllib message; 
DwtCompString nulltopic_message; 
DwtCompString overview topic; 
int rows; 
DwtCompString saveaslabel; 
DwtCompString searchapply label; 
DwtCompString searchkeywordbox_ label; 
DwtCompString search label; 
DwtCompString searchtitlebox label; 
DwtCompString selectall_label; 
DwtCompString title label; 
DwtCompString titles label; 
DwtCompString topictitles label; 
DwtCompString view _label; 
DwtCompString visitglos label; 
DwtCompString visit_label; 
DwtCallbackPtr unmap_ callback; 
RETURNS widget 
The identifier of the created widget. 
ARGUMENTS _ parent_widget 


The identifier of the parent widget. 


name 


The name of the created widget. 


override_arglist 


The application override argument list. 


override_argcount 


The number of arguments in the application override argument list. 
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WIDGET- about label 
SPECI FIC C binding: 
ATTRIBUTES 


“About”. 


VAX binding: DWT$C_NABOUT_LABEL 
DwtNaboutLabel 


The label for the About menu item in the Help menu. The default is 


add_topic_label 
VAX binding: DWT$C_NADD_TOPIC_LABEL 


C binding: 


DwtNaddtopicLabel 


The text for the label indicating additional topics for help. The default is 


“Additional topics:”. 


application_name 
VAX binding: DWT$C_NAPPLICATION_NAME 


C binding: 


DwtNapplicationName 


The application name to be used in the widget title bar. The default is 


null. 
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badframe_message 
VAX binding: DWT$C_NBADFRAME_MESSAGE 
C binding: DwtNbadframeMessage 


The text for the message displayed when a frame could not be found. The 
default is “Couldn’t find frame %s in %x library\n”. 


badlib_message 
VAX binding: DWT$C_NBADLIB_MESSAGE 
C binding: DwtNbadlibMessage 


The text for the message displayed when a requested library could not be 
found. The default is “Couldn’t open %s library\n”. 


cols 
VAX binding: DWT$C_NCOLS 
C binding: DwtNecols 


The width, in characters, of the help text window. The default is language 


- dependent; the American English default is 55. 


copy _label 
VAX binding: DWT$C_NCOPY_LABEL 
C binding: DwtNcopyLabel 


The text for the Copy menu item in the Edit menu. The default is “Copy”. 


default_position 
VAX binding: DWT$C_NDEFAULT_POSITION 
C binding: DwtNdefaultPosition 


A Boolean attribute that, if true, causes the core attributes x and y to be 
ignored and forces the default widget position. The default widget position 
is centered in the parent window. If false, the specified x and y attributes 
are used to position the widget. The default is true. 


dismiss_label 
VAX binding: DWT$C_NDISMISS_LABEL 
C binding: DwtNdismissLabel 


The text for the push button label used to dismiss a help widget dialog box 
(for example, Search History, Search Title, Search Keyword boxes). The 
default is “Dismiss”. 


edit_label 
VAX binding: DWT$C_NEDIT_LABEL 
C binding: DwtNeditLabel 


The label on the Edit pull-down menu. The default is “Edit”. 


erroropen_message 
VAX binding: DWT$C_NERROROPEN_MESSAGE 
C binding: DwtNerroropenMessage 


The text for the error message displayed when a file cannot be opened. 
The default is “Error opening file %s\ n”. 
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exit_label 
VAX binding: DWT$C_NEXIT_LABEL 
C binding: DwtNexitLabel 


The text for the push button and pull-down menu item that allows the 
user to exit from help. The default is “Exit”. 


file_label 
VAX binding: DWT$C_NFILE_LABEL 
C binding: DwtNfileLabel 


The label on the File pull-down menu. The default is “File”. 


first_topic 
VAX binding: DWT$C_NFIRST_TOPIC 
C binding: DwtNfirstTopic 


The first help topic to be displayed. If a null string is passed, the overview 
topic is displayed if provided. The overview topic is specified using the 
overview_topic attribute. If the value of overview_topic is null, an 
error message box is displayed. The default is null. 


glossary _label 
VAX binding: DWT$C_NGLOSSARY_LABEL 
C binding: DwtNglossaryLabel 


The text for the glossary menu item on the Help pull-down menu. The 
default is “Glossary”. 


glossary_topic 
VAX binding: DWT$C_NGLOSSARY_TOPIC 
C binding: DwtNglossaryTopic 


The application glossary topic. If a null string is provided, the Visit 
Glossary menu item does not appear in the View pull-down menu. The 
default is null. 


goback_label 
VAX binding: DWT$C_NGOBACK_LABEL 
C binding: DwtNgobackLabel 


The text for the Go Back menu item on the View pull-down menu and on 
the push button in the help window. Clicking on this object returns the 
user to the previous topic displayed. The default is “Go Back”. 


goover_label 
VAX binding: DWT$C_NGOOVER_LABEL 
C binding: DwtNgooverLabel 


The label for the Go to Overview item on the View pull-down menu. 
Clicking on this item causes the overview topic to appear in the help 
window. The default is “Go to Overview”. 


goto_label 
VAX binding: DWT$C_NGOTO_LABEL 
C binding: DwtNgotoLabel 
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The label for the Go To menu item.on the View pull-down menu and on 
the push button in the help widget’s dialog boxes. Clicking on this object 
after selecting a new topic displays help on the new topic in the same help 
window. The default is “Go To”. 


help_font 
VAX binding: DWT$C_NHELPFONT 
C binding: DwtNhelpFont 


The font of the text displayed in the help widget. The default is the default 
help font. 


help label 
VAX binding: DWT$C_NHELP_LABEL 
C binding: DwtNhelpLabel 


The label for the Help pull-down menu and for the Help menu item on the 
Help pull-down menu. The default is “Help”. 


help_title 


VAX binding: DWT$C_NHELPMESSAGE_TITLE 
C binding: DwtNhelpmessageTitle 


The text for the title of the help message. The default is “Message”. 
helpmessage_title_type 


VAX binding: DWT$C_NHELPMESSAGE_TITLE_TYPE 
C binding: DwtNhelpmessageTitleType 


The type of text used in the help message title. The predefined value for 
this attribute is as follows: 


VAX Cc Description 
DWT$C_CSTRNG DwtCString Compound string 


history_label 
VAX binding: DWT$C_NHISTORY_LABEL 
C binding: DwtNhistoryLabel 


The text for the History... menu item on the Search pull-down menu. The 
default is “History...”. 


historybox_label 
VAX binding: DWT$C_NHISTORYBOX_LABEL 
C binding: DwtNhistoryboxLabel 


The label for the history dialog box. The default is “Help Topic History”. 


keyword_label 
VAX binding: DWT$C_NKEYWORD_LABEL 
C binding: DwtNkeywordLabel 


The label for the Keyword... menu item in the Search pull-down menu. 
The default is “Keyword...”. 
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keywords_label 
VAX DWT$C_NKEYWORDS_LABEL 
C binding: DwtNkeywordsLabel 


The text for the label used in a Search Topic Keyword box to identify the 
text entry field. The default is “Keyword:”. 


library_spec 
VAX binding: DWT$C_NLIBRARY_SPEC 
C binding: DwtNlibrarySpec 


A host system file specification that identifies the help topic library (for 
example, “SYS$HELP:DECW$CALENDAR’” on VMS systems). The default 
is null. 


library_type 
VAX binding: DWT$C_NLIBRARY_TYPE 
C binding: DwtNlibraryType 


The type of help topic library specified by library_spec. The predefined 
value for this attribute follows: 


VMS . Cc Description 


DWT$C_TEXT_LIBRARY DwtTextLibrary VMS help text in a VMS 
help library or ULTRIX 
help directory 


nokeyword_message 
VAX binding: DWT$C_NNOKEYWORD_MESSAGE 
C binding: DwtNnokeywordMessage 


The text for the message displayed when a requested keyword cannot be 
found. The default is “Couldn’t find keyword %os\ n”. 


notitle_message 
VAX binding: DWT$C_NNOTITLE_MESSAGE 
C binding: DwtNnotitleMessage 


The text for the message displayed when a requested title cannot be found. 
The default is “No title to match string %s\n”. 


nulllib_message 
VAX binding: DWT$C_NNULLLIB_MESSAGE 
C binding: DwtNnulllibMessage 


The text for the message displayed when no library has been specified. 
The default is “No library specified\ n”. 


nulltopic_message 
VAX binding: DWT$C_NNULLTOPIC_MESSAGE 
C binding: DwtNnulltopicMessage 


The text for the message displayed when neither a first_topic nor an 
overview_topic has been specified. The default is “No first topic and 
overview topic specified\ n”. 
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overview_topic 
VAX binding: DWT$C_NOVERVIEW_TOPIC 
C binding: DwtNoverviewTopic 


The application overview topic. The default is null. 


rows 
VAX binding: DWT$C_NROWS 
C binding: DwtNrows 


Height, in characters, of the help text window. The default is language- 
dependent; the American English default is 20. 


saveas_label 
VAX binding: DWT$C_NSAVEAS_LABEL 
C binding: DwtNsaveasLabel 


The label for the Save As... item on a File pull-down menu. Clicking 
on this item allows a user to save the current help text in a file. A file 
selection dialog box is displayed. The default is “Save As...”. 


searchapply_label 
VAX binding: DWT$C_NSEARCHAPPLY_LABEL 
C binding: DwtNsearchapplyLabel 


The text for the push button label used to initiate a search action in a 
Search dialog box. The default is “Apply”. 


searchkeywordbox_label 
VAX binding: DWT$C_NSEARCHKEYWORDBOX_LABEL 
C binding: DwtNsearchkeywordboxLabel 


The text for the label used in a Search Topic Keywords dialog box. The 
default is “Search Topic Keywords”. 


search_label 
VAX binding: DWT$C_NSEARCH_LABEL 
C binding: DwtNsearchLabel 


The label for the Search pull-down menu. The default is “Search”. 


searchtitlebox_label 
VAX binding: DWT$C_NSEARCHTITLEBOX_LABEL 
C binding: DwtNsearchtitleboxLabel 


The text for the title of a Search Topic Titles box. The default is “Search 
Topic Titles”. 


selectall_ label 
VAX binding: DWT$C_NSELECTALL_LABEL 
C binding: DwtNselectallLabel 


The label for the Select All item on the Edit pull-down menu. Clicking 
on this item selects all the text in the work area (text widget only). The 
default is “Select All’. 
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title_label 
VAX binding: DWT$C_NTITLE_LABEL 
C binding: DwtNtitleLabel 


The label for the Title... item on the Search pull-down menu. Clicking 
on this entry allows a user to search for a topic by title. The default is 
“Title...”. 


titles_label 
VAX binding: DWT$C_NTITLES_LABEL 
C binding: DwtNtitlesLabel 


The text for the label identifying the text entry field on the Search Topic 
Titles box. The default is “Title:”. 


topictitles_label 
VAX binding: DWT$C_NTOPICTITLES_LABEL 
C binding: DwtNtopictitlesLabel 


The text for the label identifying topics found as a result of a title search 
in a Search Topic Titles box. The default is “Topic Titles:”. 


view_label 
VAX binding: DWT$C_NVIEW_LABEL 
C binding: DwtNviewLabel 


The label for the View menu. The default is “View”. 


visitglos_label 
VAX binding: DWT$C_NVISITGLOS_LABEL 
C binding: DwtNvisitglosLabel 


The label for the Visit Glossary item on the View pull-down menu. 
Clicking on this item causes the glossary to be displayed in a new Help 
window. The default is “Visit Glossary”. 


visit_label 
VAX binding: DWT$C_NVISIT_LABEL 
C binding: DwtNvisitLabel 


The label for the Visit item on the View pull-down menu and the Visit 
push button in a dialog box. Clicking on this object causes information on 
a selected topic to be displayed in a new window. The default is “Visit”. 


unmap_callback 
VAX binding: DWT$C_NUNMAP_CALLBACK 
C binding: DwtNunmapCallback 


The callback routine or routines called when the help widget is unmapped. 
For this callback routine, the reason is Unmap. The default is null. 





ATTRIBUTE The following common attributes are supported differently by HELP 


EXCEPTIONS CREATE: 
¢ The attributes width and height cannot be set by the caller; these 
values are calculated by the widget, based on the size of the text 
window (cols and rows). 
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CALLBACK 
DATA 31 0 
STRUCTURE 
ZK-0091A-GE 
VAX field Structure name: DWT$ANY_CB_ST 
information 
Name Usage Data Type Access Mechanism 
any_reason callback reason longword read value 
any_event event uns longword read reference 
MIT C field 
information YRS: ecu oi 
int reason; 
XEvent *event; 
} DwtAnyCallbackStruct; 
CALLBACK reason 
FIELD An integer set to the callback reason. See the Callback Reasons section for 
the values applicable to this widget. 
DESCRIPTIONS 
event 
A pointer to the X event structure describing the event that generated this 
callback. 





CALLBACK Unmap 
VAX binding: DWT$C_CRUNMAP 
REASONS ebnmag DwiCRUnmap 


The help window was just unmapped. 





DESCRIPTION HELP CREATE creates a help widget. A help widget is a modeless 
widget that enables the application to display appropriate user assistance 
information in response to a user request. When the user requests help, 
the help widget displays an initial help topic, then gives the user the 
ability to view additional help topics. 


The first_topic argument allows the application to provide context- 
sensitive help by selecting a specific topic based on implicit or explicit cues 
from the user. 
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After the widget has been created, you can change the help topic by 
specifying a new first_topic (using the intrinsic routine SET VALUES), 
and then managing the widget (using the intrinsic routine MANAGE 
CHILD) to cause the help window to appear. 


When the user exits from a help session the widget is automatically 
unmanaged. A Help widget can also be created with the high-level routine 


HELP. 
geometry The help widget does not support children. 
management 
resizing The help widget sizes itself at creation, based on rows and cols. 
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LABEL CREATE 


Creates a label widget for the application to display identification information 
(label) on the screen. 





WIDGET CLASS 
HIERARCHY eis 
\ 
composite 
common 
\ 
label 





VAX FORMAT _ widget = DWT$LABEL_CREATE 
(parent_widget, name, override_arglist, 
override_argcount) 


argument 

information Argument Usage Data Type Access Mechanism 
widget widget uns longword write value 
parent_widget widget uns longword read reference 
name char string char string read descriptor 
override_arglist arglist uns longword read reference 
override_argcount uns longword uns longword read reference 

attribute The following widget-specific attributes can be set in the override_ 

information arglist: 
Attribute Usage Data Type Access Mechanism 
label_type uns byte uns byte read value 
label comp string uns longword read reference 
margin_width dimension uns word read value 
margin_height dimension uns word read value 
alignment uns byte uns byte read value 
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Attribute Usage Data Type Access Mechanism 
pixmap pixmap uns longword read value 
margin_left dimension uns word read value 
margin_right dimension uns word read value . 
margin_top dimension uns word read value 
margin_bottom dimension uns word read value 
conform_to_text Boolean uns byte read value 








MITC FORMAT widget = DwtLabelCreate 
(parent_widget, name, override_arglist, 
override_argcount) 

argument 

information Widget DwtLabelCreate (parent widget, name, override_arglist, 

override argcount) 
Widget parent widget; 
char *name; 
ArgList override arglist; 
int override argcount; 
attribute The following widget-specific attributes can be set in the override_ 
information arglist: 
unsigned char label _ type; 
DwtCompString label; 
Dimension margin_width; 
Dimension margin_height; 
unsigned char alignment; 
Pixmap pixmap; 
Dimension margin_left; 
Dimension margin right; 
Dimension margin top; 
Dimension margin bottom; 
Boolean conform to_text; 
RETURNS widget 


The identifier of the created widget. 





ARGUMENTS 


parent_widget 
The identifier of the parent widget. 


name 
The name of the created widget. 


override_arglist 


The application override argument list. 
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override_argcount 


The number of arguments in the application override argument list. 





WIDGET- label_type 

SPECIFIC VAX binding: DWT$C_NLABEL_TYPE 
C binding: DwtNlabelType 

ATTRIBUTES : id 
The label type. The predefined values for this attribute are as follows: 
VMS Cc Description 
DWT$C_CSTRNG DwtCString Compound string (default) 
DWT$C_PIXMAP DwtPixmap Icon data in pixmap 
label 


VAX binding: DWT$C_NLABEL 
C binding: DwtNlabel 


The label for the label widget. The default is the widget name. 


margin_width 
VAX binding: DWT$C_NMARGIN_WIDTH 
C binding: DwtNmarginWidth 


The number of pixels between the border of the widget window and the 
label. The default is 2 pixels for text, 0 pixels for pixmap. 


margin_height 
VAX binding: DWT$C_NMARGIN_HEIGHT 
Chbinding:: DwtNmarginHeight 


The number of pixels between the border of the widget window and the 
label. The default is 2 pixels for text, 0 pixels for pixmap. 


alignment 
VAX binding: DWT$C_NALIGNMENT 
C binding: DwtNalignment 


The label alignment for text style. The predefined values for this attribute 
are as follows: 


VMS Cc Description 
DWT$C_ALIGNMENT_CENTER  DwtAlignmentCenter Center alignment (default) 
DWT$C_ALIGNMENT_ DwtAlignmentBeginning Alignment at the 
BEGINNING beginning 
DWT$C_ALIGNMENT_END DwtAlignmentEnd Alignment at the end 
pixmap 


VAX binding: DWT$C_NPIXMAP 
C binding: DwtNpixmap 


Icon data for the label. A pixmap is used when label_type is defined as 
pixmap. The default is null. 
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margin_left 
VAX binding: DWT$C_NMARGIN_LEFT 
C binding: DwtNmarginLeft 


The number of pixels to remain inside the left margin (margin_width) of 
the widget before the label is drawn. The default is zero. 


margin_right 
VAX binding: DWT$C_NMARGIN_RIGHT 
C binding: DwtNmarginRight 


The number of pixels to remain inside the right margin (margin_width) 
of the widget before the label is drawn. The default is zero. 


margin_top 
VAX binding: DWT$C_NMARGIN_TOP 
C binding: DwtNmarginTop 


The number of pixels to remain inside the top margin (margin_height) of 
the widget before the label is drawn. The default is zero. 


margin_bottom 
VAX binding: DWT$C_NMARGIN_BOTTOM 
C binding: DwtNmarginBottom 


The number of pixels to remain inside the bottom margin (margin_ 
height) of the widget before the label is drawn. The default is zero. 


conform_to_text 
VAX binding: DWT$C_NCONFORM_TO_TEXT 
C binding: DwtNconformToText 


A Boolean attribute that specifies whether the widget resizes to contain 
the label. When true, an intrinsic routine SET VALUES with a new label 
string causes the widget to shrink or expand to fit exactly (accounting 
for margins) the new label string. Note that the results of the attempted 
resize are up to the geometry manager. When false, the widget never 
resizes on its own. 


The default is true if the widget is created with width and height of zero; 
the default is false if the widget is created with nonzero width and height. 





ATTRIBUTE 
EXCEPTIONS 


The following common attributes are supported differently by LABEL 
CREATE: 


¢ The default for width is the width of the label or pixmap, plus two 
times margin_width. 


e The default for height is the height of the label or pixmap, plus two 
times margin_height. 


¢ The default for border_width is zero. 
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CALLBACK 

DATA 31 0 

STRUCTURE 

ZK-0091A-GE 

VAX field Structure name: DWT$ANY_CB_ST 

information ee eee 
Name Usage Data Type Access Mechanism 
any_reason callback reason longword read value 
any_event event uns longword read reference 

MIT C field 

information Epeeer oS eeeee 


int reason; 
XEvent *event; 
} DwtAnyCallbackStruct; 





CALLBACK reason . 
FIELD An integer set to the callback reason. See the Callback Reasons section for 


the values applicable to this widget. 
DESCRIPTIONS 
event 


A pointer to the X event structure describing the event that generated this 
callback. 





CALLBACK Help Requested 
VAX binding: DWT$C_CRHELP_REQUESTED 
REASONS C BAe Deer leno qiesicd : 


The user selected help. 





DESCRIPTION LABEL CREATE creates a label widget for the application to display 
read-only information anywhere within the parent widget window. A label 
widget can also be created with the high-level routine LABEL. 


geometry Because a label widget does not support children, it always refuses 

management geometry requests. 

resizing By default the label widget sizes itself to be just large enough to display 
the label. 
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LIST BOX CREATE 


Creates a list box widget. 





WIDGET CLASS 
HIERARCHY antes 
composi 
caf 
a window 
ist box 





VAX FORMAT widget = DWT$LIST_BOX_CREATE 
(parent_widget, name, override_arglist, 
override_argcount) 


argument 

information Argument Usage Data Type Access Mechanism 
widget widget uns longword write value 
parent_widget widget uns longword read reference 
name char string char string read descriptor 
override_arglist arglist uns longword read reference 
override_argcount uns longword uns longword read reference 

attribute The following widget-specific attributes can be set in the override_ 

information arglist: 
Aitribute Usage Data Type Access Mechanism 
margin_width dimension uns word read value 
margin_height dimension uns word read value 
spacing dimension uns word read value 
items. array uns longword read reference 
item_count longword uns longword read value | 
selected_items array uns longword read reference 
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Attribute 


selected_items_ 
count 


visible_item_count 
single_selection 
resize 

horiz 
single_callback 


single_confirm_ 
callback 


extend_callback 


extend_confirm_ 
callback 


Usage Data Type Access Mechanism 
uns longword uns longword read value 
longword uns longword read value 
Boolean uns byte read value 

byte uns byte read value 
Boolean uns byte read value 
callback uns longword read reference 
callback uns longword read reference 
callback uns longword read reference 
callback uns longword read reference 





MIT C FORMAT 


widget = DwtListBoxCreate 


(parent_widget, name, override_arglist, 
override_argcount) 


argument 
information 


Widget 
char 
ArgList 
int 


attribute 


information arglist: 


Dimension 
Dimension 
Dimension 
DwtCompString 
int 
DwtCompString 
int 

int 

Boolean 
unsigned char 
Boolean 
DwtCallbackPtr 
DwtCallbackPtr 
DwtCallbackPtr 
DwtCallbackPtr 
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Widget DwtListBoxCreate (parent widget, name, override arglist, 


override _argcount) 
parent widget; 
*name; 
override _arglist; 
override argcount; 


The following widget-specific attributes can be set in the override_ 


margin_width; 

margin height; 

spacing; 

*items; 

item_count; 

*selected_ items; 
selected_items_count; 
visible item_count; 
single_selection; 
resize; 

horiz; 

single_callback; 

single confirm_callback; 
extend_callback; 
extend_confirm_callback; 
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RETURNS 


widget 
The identifier of the created widget. 





ARGUMENTS 


parent_widget 
The identifier of the parent widget. 


name 


The name of the created widget. 


override_arglist 
The application override argument list. 


override_argcount 
The number of arguments in the application override argument list. 





WIDGET- 
SPECIFIC 
ATTRIBUTES 


margin_width 
VAX binding: DWT$C_NMARGIN_WIDTH 
C binding: DwtNmarginWidth 


he number of pixels between the border of the widget window and the © 
items. This sets the list box menu margin width. The default is 10 pixels. 


margin_height 
VAX binding: DWT$C_NMARGIN_HEIGHT 
C binding: DwtNmarginHeight 


The number of pixels between characters of each pair of consecutive items. 
This sets the list box menu margin height. The default is 4 pixels. 


spacing 
VAX binding: DWT$C_NSPACING 
C binding: DwtNspacing 


The spacing, in pixels, between list box entries. The default is 1 pixel. 


items 
VAX binding: DWT$C_NITEMS 
C binding: DwtNitems 


The list of items to be displayed by the list box widget. Each item in the 
list must be unique. No multiline items are allowed. When modifying 
items, always update item_count and selected_items_count. When 
items is null, item_count and selected_items_count must be zero. The 
default is null. 


item_count 
VAX binding: DWT$C_NITEMS_COUNT 
C binding: DwtNitemsCount 


The number of items in items. When item_count is zero, items does 
not have to be null. The list box widget uses item_count and selected_ 
items_count, not items, to determine if the list contains any items. 
Therefore, item_count must be specified whenever items is modified. 
The default is zero. 
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selected_items 
VAX binding: DWT$C_NSELECTED_ITEMS 
C binding: DwtNselectedItems 


The items that are selected in the list box. The last selected item is visible 
in the list box. The default is null. 


selected_items_count 
VAX binding: DWT$C_NSELECTED_ITEMS_COUNT 
C binding: DwtNselectedItemsCount 


The number of items selected in the list box. When selected_items_ 
count is zero, selected_items does not have to be null. The list box 
uses selected_items_count not selected_items to determine if the list 
contains any selected items. Therefore, selected_items_count must be 
specified whenever selected_items is modified. The default is zero. 


visible_item_count 
VAX binding: DWT$C_NVISIBLE_ITEMS_COUNT 
C binding: DwtNvisibleItemsCount 


The number of visible items. The default is as many items as can fit in the 
core attribute height. The minimum is 1 item. 


The list box widget is designed so that its height is based on the visible_ 
item_count attribute. Therefore, it is preferable to control the list box 
height by using visible_item_count rather than height. 


Applications that control list box height through height are responsible 
for handling font changes. 


single_selection 
VAX binding: DWT$C_NSINGLE_SELECTION 
C binding: DwtNsingleSelection 


A Boolean attribute that is true if only one item can be selected at a time. 
The default is true. 


resize 
VAX binding: DWT$C_NRESIZE 
C binding: DwtNresize 


Controls how the list box resizes when its children are managed and 
unmanaged and on geometry requests. The predefined values for this 
attribute are as follows: 


VAX Cc Description 


DWT$C_RESIZE_FIXED DwtResizeFixed List box does not change 
its size when items are 
added or deleted. 


DWT$C_RESIZE_GROW_ DwtResizeGrowOnly List box attempts to 

ONLY “expand as necessary 
when items are added. 
(default) 


If resize is set to Fixed, DIGITAL recommends that horiz be set true. 
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horiz 
VAX binding: DWT$C_NHORIZONTAL 
C binding: © DwtNhorizontal 


A Boolean attribute set true if the list box contains a horizontal scroll bar. 
This field cannot be changed after widget creation. The default is false. 


single_callback 
VAX binding: DWT$C_NSINGLE_CALLBACK 
C binding: DwtNsingleCallback 


The callback routine or routines called by the application when the user 
has clicked MB1 on a single item. The default is null. 


single_confirm_callback 
VAX binding: DWT$C_NSINGLE_CONFIRM_CALLBACK 
C binding: DwtNsingleConfirmCallback 


The callback routine or routines called by the application when the user 
has double clicked MB1 on a single item. The default is null. 


extend_callback 
VAX binding: DWT$C_NEXTEND_CALLBACK 
C binding: DwtNextendCallback 


The callback routine or routines called by the application when the user 
has clicked MB1 while pressing the key when more than one item is 
selected (multiple selection). See the description for the single_selection 
attribute. The default is null. 


extend_confirm_callback 
VAX binding: DWT$C_NEXTEND_CONFIRM_CALLBACK 
C binding: DwtNextendConfirmCallback 


The callback routine or routines called by the application when the user 
double clicks MB1 while pressing the key when more than one item is 
selected (multiple selection). See the description for the single_selection 
attribute. The default is null. 





ATTRIBUTE 
EXCEPTIONS 


The following common attributes are supported differently by LIST BOX 
CREATE: 


¢ The default for width is as large as necessary to hold the longest item 
without exceeding the size of its parent. 


¢ The default for height is as large as necessary to hold the number of 
items specified by visible_item_count, without exceeding the size of 
the parent widget. 


e The default for the SCROLL WINDOW CREATE attribute 
shown_value_automatic_vert is set to false. 
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CALLBACK 
DATA 31 0 
STRUCTURE 
item_length 
ZK-0093A-GE 
VAX field Structure name: DWT$LISTBOX_CB_ST 
information = 
Name Usage Data Type Access Mechanism 
listbox_reason callback longword read value 
reason 
listoox_event event uns longword read reference 
listbox_item comp string uns longword read reference ~ 
listbox_item_length longword longword read value 
listbox_item_number longword longword read value 
MIT C field 
information HUD C Gee neve a 
int reason; 
XEvent *event; 
DwtCompString item; 
int item_length; 
int item number; 
} DwtListBoxCallbackStruct; 
CALLBACK reason 
FIELD An integer set to the callback reason. See the Callback Reasons section for 
the values applicable to this widget. 
DESCRIPTIONS 


8-80 


event 
A pointer to the X event structure describing the event that generated this 
callback. 


item 
The last item selected when the callback occurred. Note that only the last 
selected item, not all selected items, is returned. 


item_length 
The length of the selected item when the callback occurred. 
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item_number 
The position of the item in the list box when the callback occurred. The 
first position is 1. 





CALLBACK 
REASONS 


Single 
VAX binding: DWT$C_CRSINGLE 
C binding: DwtCRSingle 


The user selected a single item in the list by clicking MB1 on the item. 


Single Confirm 
VAX binding: DWT$C_CRSINGLE_CONFIRM 
C binding: DwtCRSingleConfirm 


The user selected a single item in the list and confirmed another action 
to be taken (by a callback) by double clicking on an item. For example, a 
double click on a file in the file selection box selects that file and confirms 
another action to be taken. 


Extend 
VAX binding: DWT$C_CREXTEND 
C binding: DwtCRExtend 


The user selected an item (by clicking MB1 on a single item while pressing 
the key) while there is at least one other selected item. 


Extend Confirm 
VAX binding: DWT$C_CREXTEND_CONFIRM 
C binding: DwtCRExtendConfirm 


The user selected an item. and confirmed another action to be taken (by 
double clicking MB1 on a single item while pressing the [Shift] key) while 
there is at least one other selected item. This reason applies only if 
single_selection is false. The default is true. 


Help Requested 
VAX binding: DWT$C_CRHELP_REQUESTED 
C binding: DwtCRHelpRequested 


The user selected help. 





DESCRIPTION 


geometry 
management 


LIST BOX CREATE creates a list box widget. The list box widget is a 
composite widget comprising a list box, a menu with gadgets, and scroll 
bars. 


A list box widget can also be created with the high-level routine LIST 
BOX. 


The list box widget does not support children. 
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resizing 
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The size of the list box is determined by the following attributes in 
descending precedence: 


¢ height and width 
¢ visible_item_count 


° resize 


Setting the common attributes height and width overrides the widget- 
specific default settings. The following paragraphs describe the sizing 
option. 


The default list box height is determined by visible_item_count. Once 
set, the list box height does not change, regardless of the number of items 
the list box actually contains, unless the common attribute height or 
visible_item_count is modified. It is recommended that you control list 
box height by setting visible_item_count rather than height. 


The default list box width is controlled by the resize attribute. By default 
resize is true, and the list box increases its width to accommodate items 
wider than its current width. However, the list box does not shrink if 
wider items are removed. 


To keep the width of the list box constant, set width to the desired width 
and set resize to false. Also set horiz to true so that users can scroll the 
item list horizontally to see items wider than the list box. 
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MAIN WINDOW CREATE 


Creates a main window widget. 





WIDGET CLASS 
HIERARCHY asia 
sass 
sian 
fae window 





VAX FORMAT ~ widget =DWT$MAIN_WINDOW_CREATE 
(parent_widget, name, override_arglist, 
override_argcount) 


argument 

information Argument Usage Data Type Access Mechanism 
widget widget uns longword write value 
parent_widget widget uns longword “read reference 
name char string char string read descriptor 
override_arglist arglist uns longword read reference 
override_argcount — uns longword uns longword read reference 

attribute The following widget-specific attributes can be set in the override_ 

information arglist: 
Attributes Usage Data Type Access Mechanism 
command_window widget uns longword read value 
work_window widget uns longword read value 
menu_bar widget uns longword read value 
horizontal_scroll_bar widget uns longword read value 
vertical_scroll_bar widget uns longword read value 
accept_focus Boolean — uns byte read value 
focus_callback callback — uns longword read reference 
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MIT C FORMAT 


argument 
information 


attribute 
information 


widget = DwtMainWindowCreate 
(parent_widget, name, override_arglist, 
override_argcount) 


Widget DwtMainWindowCreate (parent widget, name, override arglist, 
override _argcount) 
Widget parent widget; 


char *name; 
ArgList override arglist; 
Int override argcount; 


The following widget-specific attributes can be set in the override_ 
arglist: 


Widget command window; 

Widget work window; 

Widget menu_bar; 

Widget horizontal scroll bar; 
Widget vertical scroll_bar; 
Boolean accept _focus; 
DwtCallbackPtr focus_callback; 





RETURNS 


widget 
The identifier of the created widget. 





ARGUMENTS 


parent_widget 

The identifier of the parent widget. For some applications, the parent 
widget identifier for the main window widget is the identifier returned by 
the intrinsic routine INITIALIZE. However, the main window widget is 
not restricted to this type of parent. 


name 
The name of the created widget. 


override_arglist 
The application override argument list. 


override_argcount 


The number of arguments in the application override argument list. 





WIDGET- 
SPECIFIC 
ATTRIBUTES 


command_window 
VAX binding: DWT$C_NCOMMAND_WINDOW 
C binding: DwtNcommandWindow 


The widget identifier for the command window to be associated with the 
main window widget. This cannot be supplied at main window creation 
time, but can be set or specified after creation. The default is null. 
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work_window 
VAX binding: DWT$C_NWORK_WINDOW 
C binding: DwtNworkWindow 


The widget identifier for the work window to be associated with the main 
window widget. This cannot be supplied at main window creation time, 
but can be set or specified after creation. The default is null. 


menu_bar 
VAX binding: DWT$C_NMENU_BAR 
C binding: DwtNmenuBar 


The widget identifier for the menu bar to be associated with the main 
window widget. This cannot be supplied at main window creation time, 
but can be set or specified after creation. The default is null. 


horizontal_scroll_bar 
VAX binding: DWT$C_NHORIZONTAL_SCROLL_BAR 
C binding: DwtNhorizontalScrollBar 


The widget identifier for the scroll bar to be used as the horizontal scroll 
bar in the main window widget. This cannot be supplied at main window 
creation time, but can be set or specified after creation. The default is 
null. 


vertical_scroll_bar 
VAX binding: DWT$C_NVERTICAL_SCROLL_BAR 
C binding: DwtNverticalScrollBar 


The widget identifier for the scroll bar widget to be used as the vertical 
scroll bar in the main window widget. This cannot be supplied at main 
window creation time, but can be set or specified after creation. The 
default is null. 


accept_focus | 
VAX binding: DWT$C_NACCEPT_FOCUS 


C binding: DwtNacceptFocus 


A Boolean attribute that specifies whether the main window widget 
accepts the input focus. When the main window widget is asked to accept 
the input focus, it attempts to give the input focus first to the work 
window, and then to the command window. If neither the work window 
nor the command window accepts the input focus and accept_focus is 
true, the main window widget accepts the input focus itself. If false, the 
main window widget does not accept the input focus. The default is false. 


focus_callback 
VAX binding: DWT$C_NFOCUS_CALLBACK 
C binding: DwtNfocusCallback 


The callback routine or routines called when the main window has 
accepted the input focus. For this routine, the callback reason is Focus. 
The default is null. 
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ATTRIBUTE The following common attributes are not supported by MAIN WINDOW 
EXCEPTIONS CREATE: 
/  ¢ font 

¢ highlight 

¢ highlight_pixmap 

The following common attributes are supported differently by MAIN 

WINDOW CREATE: 

e The default value of the common attributes width and height is 

5 pixels. 
CALLBACK 
DATA 31 0 
STRUCTURE 
ZK-0091 A-GE 

VAX field Structure name: DWT$ANY_CB_ST 
information 

Name Usage Data Type Access Mechanism 

any_reason callback reason longword read value 

any_event event uns longword read reference 
MIT C field 
information Pypecer eerner 

int reason; 
XEvent *event; 

} DwtAnyCallbackStruct; 
CALLBACK reason . 
FIELD An integer set to the callback reason. See the Callback Reasons section for 

the values applicable to this widget. 
DESCRIPTIONS 


event 
A pointer to the X event structure describing the event that generated this 
callback. 
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CALLBACK 
REASONS 


Focus 
VAX binding: DWT$C_CRFOCUS 
C binding: DwtCRFocus 


The main window widget has received the input focus. 


Help Requested 
VAX binding: DWT$C_CRHELP_REQUESTED 
C binding: DwtCRHelpRequested 


The user selected help. 





DESCRIPTION 


geometry 
management 


MAIN WINDOW CREATE creates a main window widget. It can contain 
a menu bar region, a work area with optional scroll bars, and a command 
area. 


A main window widget can also be created with the high-level routine 
MAIN WINDOW. 


The main window widget tiles the insides of its window with up to five 
children, as follows: 


¢ The child widget designated as the menu bar widget is placed at the 
top and extends all the way across the main window. The height of the 
menu bar widget is set to whatever the menu requests. 


¢ The child widget designated as the command widget is placed at the 
bottom and extends all the way across the main window. The height of 
the command widget is not altered. 


¢ The child widget designated as the horizontal scroll bar widget is 
placed just above the command widget (if there is no command widget, 
it is placed at the bottom). The width of the horizontal scroll bar is the 
width of the main window minus the width of the vertical scroll bar. 
The height is not altered. 


¢ The child widget designated as the vertical scroll bar widget is placed 
on the right edge below the menu bar. The height is the distance 
between the bottom of the menu bar and the top of the horizontal 
scroll bar. The width is not altered. 


¢ The child widget designated as the work area fills the area under the 
menu bar, to the left of the vertical scroll bar and above the horizontal 
scroll bar. Both dimensions are altered. 


Note that designating which child fills which role can be accomplished in 
three ways: 


e Use the high-level routine MAIN WINDOW SET AREAS to explictly 
designate which child is which. 


¢ Call the intrinsic routine SET VALUES and set the area attributes 
with the appropriate widget identifiers. 


8-87 


Low-Level Widget Routines 
MAIN WINDOW CREATE 


resizing 
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Let the main window widget determine which child is which, by using 
the following algorithm. Only currently managed children are eligible 
to be designated for a role, as follows: 


— Achild of menu widget class (or subclass) is assumed to be the 
menu bar. 


— Achild of command widget class (or subclass) is assumed to be the 
command widget. 


— A child of scroll widget class (or subclass) is either the horizontal 
_or vertical scroll bar, which is determined by looking at the 
orientation attribute of the child. 


— A child of any other class is assumed to be the work area. 


For many applications, using the intrinsic routines SET AREAS or SET 
VALUES is redundant. A single main widget might have a number of 
menu bars as children. By managing and unmanaging the menu bar 
children appropriately, the application can switch between menu bars 
without using SET AREAS or SET VALUES. 


The size of the main window widget can be specified in two ways: 


Specifying a nonzero height and width at widget creation time. In this 
case, the main window widget does not change its size on a geometry 
request from one of its children. 


Specifying zero for both height and width at widget creation time. In 
this case, the main window widget uses the width and height of the 
widget designated as the work area widget in determining its width 
and height. The main window widget does not alter the width and 
height of the work area widget and places the remaining widgets 
based upon the size of the work area. The work area widget can later 
request a size change. The main window widget will honor the request 
and reconfigure its size. 


As a geometry manager, the main window widget allows the following 
requests: 


The menu bar, command window, and horizontal scroll bar can change 
height. 


The vertical scroll bar can change width. 


The work area can change width and height, if the main menu widget 
was created with a width and height of zero. 


When resized, the main window widget reformats itself as described 
previously. 


Low-Level Widget Routines 
MENU BAR CREATE 


MENU BAR CREATE 


Creates a menu bar widget. 





WIDGET CLASS 
HIERARCHY cere 
ance 
ans 
eh bar 





VAX FORMAT _~ widget = DWT$MENU_BAR_CREATE 
(parent_widget, name, override_arglist, 
override_argcount) 


argument 

information Argument Usage Data Type Access Mechanism 
widget widget uns longword write value 
parent_widget widget uns longword read reference 
name char string char string read descriptor 
override_arglist arglist uns longword read reference 
override_argcount — uns longword uns longword read reference 

attribute The widget-specific attributes described in the low-level routine MENU 

information CREATE can be set in the override_arglist. 





MIT CFORMAT widget = DwtMenuBarCreate 
(parent_widget, name, override_arglist, 
override_argcount) 


argument 
information Widget DwtMenuBarCreate (parent_widget, name, override arglist, 
overide argcount) 
Widget parent widget; 
char *Aname; 
Arglist override_arglist; 
ant override_argcount; 
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The widget-specific attributes described in the low-level routine MENU 
CREATE can be set in the override_arglist. 





RETURNS widget 
The identifier of the created widget. 


ARGUMENTS _ parent_widget 


The identifier of the parent widget. 


name 
The name of the created widget. 


override_arglist 
The application override argument list. 


override_argcount 


The number of arguments in the application override argument list. 











WIDGET- See the widget-specific attributes for the low-level routine MENU 
SPECIFIC wien 

ATTRIBUTES 

ATTRIBUTE The following common attributes are supported differently by MENU BAR 


EXCEPTIONS CREATE: 


e Setting the sensitivity of the menu bar causes all widgets contained in 
that menu bar to be set to the same sensitivity as the menu bar. 


¢ The default of width is 16 pixels. 


¢ The default of height is the number of lines needed to display all 
entries. 


¢ The Font attribute is used only by gadget children. 


The following attribute from MENU CREATE is supported differently: 
¢ The default for margin_height is 0 pixels. 





CALLBACK See the low-level routine MENU CREATE. 


STRUCTURE 


DESCRIPTION MENU BAR CREATE creates a menu bar widget. A menu bar widget is 
a composite widget that contains pull-down menu entry subwidgets. The 
subwidgets handle most of the I/O activity that displays information and 
queries the user for input. The menu bar provides no input semantics over 
and above the semantics of its subwidgets. 





7 


90 
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If the menu bar does not have enough room to fit all its subwidgets on 
a single line, the menu bar attempts to wrap the remaining entries onto 
additional lines (if allowed by the geometry manager of the parent widget). 


The menu bar widget works with widget classes: pull-down menu entries, 
labels, and separators. If the menu attribute entry_callback is not null 

when it is activated, all subwidgets call back to this callback. Otherwise, 

activation callbacks are handled by the individual subwidgets. 


A menu bar widget can also be created with the high-level routine MENU 


BAR. 
geometry See the low-level routine MENU CREATE. 
management 
resizing See the low-level routine MENU CREATE. 
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MENU CREATE 


Creates a menu widget. 








WIDGET CLASS 
HIERARCHY oe 
\ 
composite 
\ 
common 
\ 
menu 
VAX FORMAT _~ widget = DWT$MENU_CREATE 


argument 
information 


attribute 
information 
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(parent_widget, name, override_arglist, 


override_argcount) 


Argument 


widget 
parent_widget 
name 
override_arglist 


override_argcount 


Usage 


widget 
widget 


char string 


arglist 


uns longword 


Data Type 


uns longword 
uns longword 
char string 

uns longword 
uns longword 


Access 


write 
read 
read 
read 
read 


Mechanism 


value 

reference 
descriptor 
reference 
reference 


The following widget-specific attributes can be set in the override_ 


arglist: 


Argument 


orientation 
spacing 
adjust_margin 
margin_width 
margin_height 
entry_border 


menu_alignment 
entry_alignment 


Usage 


uns byte 
dimension 
Boolean 
dimension 
dimension 
dimension 
Boolean 
alignment 


Data Type 


uns longword 
uns word 
uns byte 
uns word 
uns word 
uns word 
uns byte 
uns longword 


Access 


read 
read 
read 
read 
read 
read 
read 
read 


Mechanism 


value 
value 
value 
value 
value 
value 
value 
value 


Argument 


menu_packing 


menu_num_ 
columns 


menu_radio 
radio_always_one 


menu_is_ 
homogeneous 


menu_entry_class 
menu_history 
help_callback 
entry_callback 
map_callback 
unmap_callback 
menu_help_widget 
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Usage Data Type Access Mechanism 
uns byte uns longword read value 
uns longword uns longword read value 
Boolean uns byte read value 
Boolean uns byte read value 
Boolean uns byte read value 
widget class identifier read value 
widget uns longword read value 
callback uns longword read reference 
callback uns longword read reference 
callback uns longword read reference 
callback uns longword read reference 
widget uns longword read value 





MIT C FORMAT 


argument 
information 


attribute 
information 


widget = DwiMenuCreate 
(parent_widget, name, override_arglist, 
override_argcount) 


Widget DwtMenuCreate (parent widget, name, override _arglist, 


Widget 
char 
ArgList 
int 


override _argcount) 
parent widget; 
*Aname; 
override arglist; 
override argcount; 


The following widget-specific attributes can be set in the override_ 


arglist: 


unsigned char 
Dimension 
Boolean 
Dimension 
Dimension 
Dimension 


orientation; 
spacing; 
adjust_margin; 
margin _width; 
margin height; 
entry border; 
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Boolean 
unsigned char 
unsigned char 


menu_alignment; 
entry alignment; 
menu_packing; 











int menu_num_columns; 
Boolean menu_radio; 
Boolean radio always one; 
Boolean menu_is homogeneous; 
WidgetClass menu_entry class; 
Widget menu_history 
DwtCallbackPtr help callback; 
DwtCallbackPtr entry callback; 
DwtCallbackPtr map_callback; 
Dwt,CallbackPtr unmap_callback; 
Widget menu_help widget; 
RETURNS widget 7 
The identifier of the created widget. 
ARGUMENTS _ parent_widget 
The identifier of the parent widget. 
name 
The name of the created widget. 
override_arglist 
The application override argument list. 
override_argcount 
The number of arguments in the application override argument list. 
WIDGET- orientation 
SPECIFIC VAX binding: DWT$C_NORIENTATION 
C binding: DwtNorientation 
ATTRIBUTES are 
The menu orientation. The predefined values for this attribute are as 
follows: 
VMS Cc Description 
DWT$C_ORIENTATION_ = DwtOrientationHorizontal Horizontal menu 
HORIZONTAL 
DWT$C_ORIENTATION_ DwtOrientationVertical Vertical menu 
VERTICAL 
spacing 


VAX binding: DWT$C_NSPACING 


C binding: 


DwtNspacing 


The spacing, in pixels, between menu bar entry windows. The default is 


0 pixels. 
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adjust_margin 
VAX binding: DWT$C_NADJUST_MARGIN 
C binding: DwtNadjustMargin 


A Boolean attribute that indicates whether the inner minor dimension 
margins of all entries should be set to the same value. The default is true. 


All label subclass widgets have two types of margins. The two outer 
margins (margin_width and margin_height) are symmetrical about 
the center of the widget. The attribute margin_width specifies the 
number of blank pixels to the right and to the left of the widget. The four 
inner margins (margin_left, margin_right, margin_top, and margin_ 
bottom) specify the number of blank pixels to leave inside the outer 
margins. 


The outer margins are used to accommodate features like border 
highlighting of widgets. The inner margins are used to accommodate 
features like pull-down widget hot spots and toggle button indicators. 


If this attribute is true, all entries in a given column or row have exactly 
the same minor dimension margins. (If orientation is horizontal, 

the minor dimension is vertical; if orientation is vertical, the minor 
dimension is horizontal.) All margins have the value of the largest 
individual margin in the group. This aligns the left edge of text regardless 
of whether some entries have toggle indicators. 


The default is true. 


margin_width 
VAX binding: DWT$C_NMARGIN_WIDTH 
C binding: DwtNmarginWidth 


The number of blank pixels remaining around the menu entries. The 
width is the number of blank pixels between the left and right edges of the 
menu and the border of the entries. The default is 3. 


margin_height 
VAX binding: DWT$C_NMARGIN_HEIGHT 
C binding: DwtNmarginHeight 


The number of blank pixels remaining around the menu entries. The © 
height is the number of blank pixels above the first entry and below the 
last entry (for vertical menus). The default is 3. 


entry_border 
VAX binding: DWT$C_NENTRY_BORDER 
C binding: DwtNentryBorder 


The border width, in pixels, of menu bar entry windows. The default is 0 
pixels. 


menu_alignment 
VAX binding: DWT$C_NMENU_ALIGNMENT 
C binding: DwtNmenuAlignment 


A Boolean attribute that specifies whether the menu entries should 
all have the same text alignment. If true, all entries are aligned. If 
false, entry alignment is unchanged. This applies only to subclasses of 
labelwidgetclass. The default is true. 
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VMS 


entry_alignment 
VAX binding: DWT$C_NENTRY_ALIGNMENT 
C binding: DwtNentryAlignment 


The type of label alignment that is enforced for all entries when menu_ 
alignment is true. The predefined values for this attribute are as follows: 


VMS Cc Description 
DWT$C_ALIGNMENT_CENTER  DwtAlignmentCenter Center alignment 
DWT$C_ALIGNMENT_ DwtAlignmentBeginning Alignment at the 
BEGINNING beginning (default) 
DWT$C_ALIGNMENT_END DwtAlignmentEnd Alignment at the end 


menu_packing 
VAX binding: DWT$C_NMENU_PACKING 
C binding: DwtNmenuPacking 


The placement of menu entries into the menu. The value of orientation 
determines the major dimension. The predefined values for this attribute 
are as follows: 


Cc Description 


DWT$C_MENU_PACKING_ DwtNmenuPackingTight Given the current major dimension of the menu, 


TIGHT 


entries are placed one after the other until the menu 
must wrap. When the menu wraps, it extends in the 
minor dimension as many times as required. 


Each entry’s major dimension is unchanged; its minor 
dimension is set to the same value as the longest 
entry in that particular row or column. Note that the 
minor dimension of any particular row or column is 
independent of the minor dimension of other rows or 
columns. 


DWT$C_MENU_PACKING_ DwtNmenuPackingColumn All entries are placed in identically sized boxes based 


COLUMN 


on the size of the largest entry. The value of menu_ 
num_columns determines how many boxes are 
placed in the major dimension before extending in the 
minor dimension. 


DWT$C_MENU_PACKING_ DwtNmenuPackingNone No packing is performed. The x and y attributes 


NONE 
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of each entry are left alone. The menu attempts to 
become large enough to enclose all entries. 


The default is Menu Packing Tight for all menu types except for radio 
boxes. Radio box menus default to Menu Packing Column. 


menu_num_columns 
VAX binding: DWT$C_NMENU_NUM_COLUMNS 
C binding: DwtNmenu_num_columns 


The number of minor dimension extensions that can be made to 
accommodate the entries. This attribute is only used if the 


-menu_packing attribute has the value Menu Packing Column. The 


default is 1. 
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For menus with vertical orientation, this attribute indicates how many 
columns are built. The number of entries per column is adjusted to 
maintain this number of columns (if possible). For menus with horizontal 
orientation, this attribute indicates how many rows are built. 


menu_radio 
VAX binding: DWT$C_NMENU_RADIO 
C binding: DwtNmenuRadio 


Indicates whether or not radio button exclusivity is enforced. If true, when 
one button is on and another button is turned on, the first one is turned 
off automatically. 


The default is false except for radio box menus, which default to true. 


radio_always_one 
VAX binding: DWT$C_NRADIO_ALWAYS_ONE 
C binding: DwtNradioAlwaysOne 


Indicates if the radio button exclusivity also ensures that one button must 
always be on. If true, when the only radio button on is turned off, it is 
automatically turned back on. 


The default is true. Note that this attribute has no effect unless 
menu_radio is true. 


menu_is_ homogeneous 
VAX binding: DWT$C_NMENU_IS_ HOMOGENEOUS 
C binding: DwtNmenulsHomogeneous 


A Boolean attribute that indicates if the menu enforces exact homogeneity 
among the children of this menu. If true, then only widgets from the 
widget class specified in menu_entry_class (not subclass but exact class) 
are allowed as children of the menu. 


The default is false, except for radio boxes which default to true. 


menu_entry_class 
VAX binding: DWT$C_NMENU_ENTRY_CLASS 
C binding: DwtNmenuEntryClass 


The class of child widgets that can be added to the menu. If menu_is_ 
homogeneous is true, only the class of widgets specified by this attribute 
widgets can be added to the menu. All other classes of widgets produce a 
warning message. 


The default is null, except for radio box menus which default to the 
togglebuttonwidgetclass. 


menu_history 
VAX binding: DWT$C_NMENU_HISTORY 
C binding: DwtNmenuHistory 


The widget identifier of the last menu entry which was activated. If 
menu_radio is true, menu_history holds the widget identifier of the 
last toggle button to change from off to on. This attribute can be set to 
pre-condition option menus and pop-up menu mouse memory. The default 
is null. 
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ATTRIBUTE 


EXCEPTIONS 


8-98 


help_callback 
VAX binding: DWT$C_NHELP_CALLBACK 
C binding: DwtNhelpCallback 


The callback routine or routines to be called back on a help request. The 
default is null. 


entry_callback 
VAX binding: DWT$C_NENTRY_CALLBACK 
C binding: DwtNentryCallback 


If this callback is defined, all menu entry activation callbacks are 
revectored to call back through this callback. If this callback is null, 
then individual menu entry callbacks work as usual. The reason for this 
callback is Activate. The default is null. 


map_callback 
VAX binding: DWT$C_NMAP_CALLBACK 
C binding: DwtNmapCallback 


The callback routine or routines called when the window is about to be 
mapped. For this routine, the reason is Map. The default is null. 


unmap_callback 
VAX binding: DWT$C_NUNMAP_CALLBACK 
C binding: DwtNunmapCallback 


The callback routine or routines called when the window is unmapped. 
For this routine, the reason is Unmap. The default is null. 


menu_help_widget 
VAX binding: DWT$C_NMENU_HELP_WIDGET 
Chbinding:: DwtNmenuHelpWidget 


If not null, the help widget points to the menu item to be placed in the 
bottom right corner of the menu bar. The default is null. 


The following common attributes are supported differently by MENU 
CREATE: 


¢ The height and width attributes depend on the orientation, the 
number of managed children, and the value of menu_packing. 


e The default for border_width is 1 pixel. 
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CALLBAC 
DATA 
STRUCTURE 


VAX field 
information 






31 0 






ZK-0094A-GE 

Structure name: DWT$MENU_CB_ST 
Name Usage Data Type Access Mechanism 
menu_reason callback longword read value 

reason 
menu_event event uns longword read reference 
menu_s_widget widget longword read reference 
menu_s_tag longword uns longword read value 
menu_s_callbackstruct callback uns longword read reference 





MIT C field 
information i alone ce 
int reason; 
XEvent *event; 
Widget s widget; 
char *s tag; 
char *s callbackstruct; 
} DwtMenuCallbackStruct; 
CALLBACK reason eS 
FIELD An integer set to the callback reason. See the Callback Reasons section for 
the values applicable to this widget. 
DESCRIPTIONS 


event 
A pointer to the X event structure describing the event that generated this 
callback. 


s widget 
The identifier of the activating subwidget. 
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s tag 
The tag supplied by the application programmer when the subwidget 
callback routine was specified. 


s_callbackstruct 
The callback structure of the subwidget. 





CALLBACK 
REASONS 


Activate 
VAX binding: DWT$C_CRACTIVATE 
C binding: DwtCRActivate 


The user selected a menu entry. 
Map 


VAX binding: DWT$C_CRMAP 
C binding: DwtCRMap 


The menu window is about to be mapped. 


Unmap 
VAX binding: DWT$C_CRUNMAP 
C binding: DwtCRUnmap 


The menu window was just unmapped. 


Help Requested 
VAX binding: DWT$C_CRHELP_REQUESTED 
C binding: DwtCRHelpRequested 


The user selected help. 





DESCRIPTION 


geometry 
management 
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MENU CREATE creates a menu widget. 


The menu widget is a composite widget that contains other widgets (push 
buttons, pull-down menu widgets, toggle buttons, labels, and separators). 
The subwidgets handle most I/O that display information and query the 
user for input. The menu widget provides no input semantics over and 
above the semantics of its subwidgets. 


The menu widget works with widget subclasses: push buttons, toggle 
buttons, pull-down menu entries, labels, and separators. 


A menu widget can also be created with the high-level routine MENU. 


In general, a menu enforces positions, dimensions, and border widths 
for all children. In a vertical menu, entries have uniform widths—the 
width of the widest item in the current column. The height of each entry 
is unaffected and is the responsibility of the item itself. In a horizontal 
menu, items have uniform height; the width is unaffected. 


In all menu packing modes except Menu Packing None, position of an item 
is completely determined by the menu; the child widget has no control of 
its position. In the None packing mode, the menu does not position items. 


resizing 
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A menu complies with all geometry requests made by its children. The 
menu determines the size needed to resize around its managed children 
and then makes the request of its geometry manager. Even if the menu’s 
parent does not allow the request, the menu resizes. The child may then 
be clipped. 


Height and width of a menu child are jointly controlled by the menu and 
the child. If a child requests a larger size, the menu accepts the request 
and then resizes all the other children to match. If a child requests a 
smaller size, the menu accepts the request; however, the menu might 
make the child bigger again as the menu resizes the other children. 


If menu_uniform_border is true, all entries have exactly the same 
border width. If menu_uniform_border is false, the menu does not 
change any of the children’s border widths. 


When a menu widget is resized, it places all its managed children in 
exactly the same manner as described in the geometry management 
section. 
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MENU POPUP CREATE 


Creates a pop-up menu widget. 








WIDGET CLASS 
HIERARCHY 2 
\ 
composite 
\ 
common 
\ 
menu popup 
FORMAT widget = DWT$MENU_POPUP_CREATE 
(parent_widget, name, override_arglist, 
override_argcount) 
argument 
information Argument Usage Data Type Access Mechanism 
widget widget uns longword write value 
parent_widget widget uns longword read reference 
name char string ~ char string read descriptor 
override_arglist arglist uns longword read reference 
override_argcount — uns longword uns longword read reference 


The widget-specific attributes described in the low-level routine MENU 
CREATE can be set in the override_arglist. 





MIT C FORMAT widget = DwtMenuPopupCreate 
(parent_widget, name, override_arglist, 
override_argcount) 


argument 
information Widget DwtMenuPopupCreate (parent_widget, name, override_arglist, 
override argcount) 
Widget parent _widget; 


char *name; 
ArgList override arglist; 
int override argcount; 


The widget-specific attributes described in the low-level routine MENU 
CREATE can be set in the override_arglist. 
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RETURNS widget 


The identifier of the created widget. 





ARGUMENTS _ parent_widget 
The identifier of the parent widget. 


name 
The name of the created widget. 


override_arglist 


The application override argument list. 


override_argcount 


The number of arguments in the application override argument list. 








WIDGET- See the widget-specific attributes for the low-level routine MENU 
SPECIFIC sais 

ATTRIBUTES 

ATTRIBUTE The following common attributes are supported differently by MENU 


EXCEPTIONS POPUP CREATE: 


¢ The defaults for width and height are set as large as necessary to 
hold all child widgets. 





CALLBACK See the low-level routine MENU CREATE. 
DATA 
STRUCTURE 


DESCRIPTION MENU POPUP CREATE creates a pop-up menu widget. 





geometry See the low-level routine MENU CREATE. 
management 
resizing See the low-level routine MENU CREATE. 
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MENU PULLDOWN CREATE 


Creates a pull-down menu. 








WIDGET CLASS 
HIERARCHY — 
\ 
composite 
\ 
common 
\ 
menu pulldown 
FORMAT widget = DWT$MENU_PULLDOWN_CREATE 
(parent_widget, name, override_arglist, 
override_argcount) 
argument 
information Argument Usage Data Type Access Mechanism 
widget widget uns longword write value 
parent_widget widget uns longword read reference 
name char string char string read descriptor 
override_arglist arglist uns longword read reference 
override_argcount — uns longword uns longword read reference 


The widget-specific attributes described in the low-level routine MENU 
CREATE can be set in the override_arglist. 





MIT C FORMAT widget = DwtMenuPulldownCreate 
(parent_widget, name, override_arglist, 
override_argcount) 


argument 
information Widget DwtMenuPulldownCreate (parent_widget, name, 
override arglist, 
override argcount) 
Widget parent_widget; 


char “*name; 
ArgList override_arglist; 
int override _argcount; 


8-104 


Low-Level Widget Routines - 
MENU PULLDOWN CREATE 


The widget-specific attributes described in the low-level routine MENU 
CREATE can be set in the override_arglist. 





RETURNS widget 
Identifier of the created widget. 





ARGUMENTS _ parent_widget 


identifier of the parent widget. 


name 
The name of the created widget. 


override_arglist 
The application override argument list. 


override_argcount 


The number of arguments in the application override argument list. 











WIDGET- See the widget-specific attributes for the low-level routine MENU 
SPECIFIC aaa 
ATTRIBUTES 
ATTRIBUTE The following core attributes are not supported by MENU PULLDOWN 
EXCEPTIONS CREATE: 
° x 
= ee 
The following core attributes are supported differently by MENU 
PULLDOWN CREATE: 
e The default for width is set as large as necessary to hold all child 
widgets. 
¢ The default for height is set as large as necessary to hold all child 
widgets. 
CALLBACK See the low-level routine MENU CREATE. 
DATA 
STRUCTURE 


DESCRIPTION MENU PULLDOWN CREATE creates a pull-down menu widget. 





geometry See the low-level widget routine MENU CREATE. 
management 
resizing See the low-level widget routine MENU CREATE. 
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MESSAGE BOX CREATE 


Creates a message box widget. 





WIDGET CLASS 
HIERARCHY eark 
eee 
oe 
aes 


\ 
message box 





VAX FORMAT ~~ widget = DWT$MESSAGE_BOX_CREATE 
(parent_widget, name, override_arglist, 
override_argcount) 


argument 

information Argument Usage Data Type Access Mechanism 
widget widget uns longword write value 
parent_widget widget uns longword read reference 
name char string char string read descriptor 
override_arglist arglist uns longword read reference 
override_argcount — uns longword uns longword read reference 

attribute The following widget-specific attributes can be set in the override_ 

information arglist: 
Attribute Usage Data Type Access Mechanism 
label comp string uns longword read reference 
ok_label comp string uns longword read reference 
yes_callback callback uns longword read reference 





MITC FORMAT widget = DwtMessageBoxCreate 
(parent_widget, name, override_arglist, 
override_argcount) 
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argument 
information 


attribute 
information 


Low-Level Widget Routines 
MESSAGE BOX CREATE 


Widget DwtMessageBoxCreate (parent widget, name, override _arglist, 
override argcount) 
Widget parent_widget; 
char *name; 
ArgList override _arglist; 
int override argcount; 


The following widget-specific attributes can be set in the override_ 
arglist: 


DwtCompString label; 
DwtCompString ok_label; 
DwtCallbackPtr yes _ callback; 





RETURNS 


widget 
The identifier of the created widget. 





ARGUMENTS 


parent_widget 
The identifier of the parent widget. 


name 
The name of the created widget. 


override_arglist 


The application override argument list. 


override_argcount 


The number of arguments in the application override argument list. 





WIDGET- 
SPECIFIC 
ATTRIBUTES 


label 
VAX binding: DWT$C_NLABEL 
C binding: DwtNlabel 


The text in the message line or lines. This argument defaults to the 
widget name. 


ok label 
VAX binding: DWT$C_NOk_LABEL 
C binding: DwtNokLabel 


The label for the OK push button. If the label is a null string, the button 
is not displayed. The default is “Acknowledged”. 


yes_callback 
VAX binding: DWT$C_NYES_CALLBACK 
C binding: DwtNyesCallback 


The callback routine or routines called when the OK button is activated. 
The default is null. 
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ATTRIBUTE The following common attribute is not supported by MESSAGE BOX 
EXCEPTIONS “SHAT: 

e direction_r_to_l 

The following attributes inherited from DIALOG BOX POPUP CREATE 

are not supported: 

¢ cancel_button 

e child_overlap 

¢ default_button 

e text_merge_translation 

e §6title_type 

* units 

The following attributes inherited from DIALOG BOX POPUP CREATE 

are supported differently: 

e The resize attribute is set to Shrink Wrap. 

e The default for margin_width is 12 pixels. 

¢ The default for margin_height is 10 pixels. 

¢ The default for style is Modal. 













CALLBACK 

DATA 31 0 

STRUCTURE 

ZK-0091A-—GE 

VAX field Structure name: DWT$ANY_CB_ST 

information | 
Name Usage Data Type Access Mechanism 
any_reason callback reason longword read value 
any_event event uns longword - read reference 

MIT C field 

information Eypedsr -serece a 


int reason; 
XEvent *event; 
} DwtAnyCallbackStruct; 
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CALLBACK reason . 

FIELD An integer set to the callback reason. See the Callback Reasons section for 
the values applicable to this widget. 

DESCRIPTIONS 
event 
A pointer to the X event structure describing the event that generated this 
callback. 

CALLBACK Yes : 
VAX binding: DWT$C_CRYES 

REASONS C binding: DwtCRYes 
The user activated the OK push button. 
Help Requested 
VAX binding: DWT$C_CRHELP_REQUESTED 
C binding: DwtCRHelpRequested 
The user selected help somewhere in the message box (reason in callback 
data). 

DESCRIPTION _ The message box widget is a dialog box that allows the application to 
display informational messages to the user. Call this routine to create 
a message box when the user does something unexpected, or when your 
application needs to display information to the user. 
The box can contain an OK push button (whose label is Acknowledged by 
default). When style is Modal, the message box freezes the application 
and requires the user to explicitly dismiss the message box before the 
application proceeds. If the style is Modal when the user selects the OK 
push button, the widget is cleared from screen but not destroyed. The 
widget can be displayed again by using the intrinsic routine MANAGE 
CHILD. 
A message box widget can also be created with the high-level routine 
MESSAGE BOX. 

geometry The message box widget follows the same rules for geometry management 

management as its superclass the dialog box widget, described in the low-level routine 
DIALOG BOX CREATE. 

resizing The message box widget follows the same rules for resizing as its 


superclass the dialog box widget, described in the low-level routine 
DIALOG BOX CREATE. 
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OPTION MENU CREATE 


Creates an option menu widget. 





WIDGET CLASS | 
HIERARCHY baie 
Essie 
ae 
ts menu 





VAX FORMAT __ widget = DWT$OPTION_MENU_CREATE 
(parent_widget, name, override_arglist, 
override_argcount) 


argument 

information Argument Usage Data Type Access Mechanism 
widget widget uns longword write value 
parent_widget widget uns longword read reference 
name char string char string read descriptor 
override_arglist arglist uns longword read reference 
override_argcount uns longword uns longword read reference 


The following widget-specific attributes can be set in the override_ 


arglist: 

Attribute Usage Data Type Access Mechanism 
label comp string uns longword read reference 
sub_menu_id widget longword read reference 





MITC FORMAT widget = DwtOptionMenuCreate 
(parent_widget, name, override_arglist, 
override_argcount) 
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argument 
information Widget DwtOptionMenuCreate (parent widget, name, override arglist, 
override _argcount) 
Widget parent widget; 
char *name; 
ArgList override arglist; 
int override _argcount; 
The following widget-specific attributes can be set in the override_ 
arglist: 
DwtCompString label; 
Widget sub_menu_id; 
RETURNS widget 


The identifier of the created widget. 





ARGUMENTS _ parent_widget 
The identifier of the parent widget. 


name 
The name of the created widget. 


override_arglist 
The application override argument list. 


override_argcount 


The number of arguments in the application override argument list. 





WIDGET- label « 
SPECIFIC ¢ binding: DWT$C_NLABEL 
ATTRIBUTES 9 Ons PwtNlabel 


The label to be placed to the left of the current value. The default is the 
widget name. 


sub_menu_id 
VAX binding: DWT$C_NSUB_MENU_ID 
C binding: | DwtNsubMenuld 


The widget identifier of the pull-down menu associated with the option 
menu during widget creation. The default is zero. 





ATTRIBUTE The following common attributes are supported differently by OPTION 
EXCEPTIONS MENU CREATE: 


¢ The defaults for width and height are set as large as necessary to 
hold all child widgets. 


¢ The font argument is used only for gadget children. 
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CALLBACK See the low-level routine MENU CREATE. 


DATA 
STRUCTURE 


DESCRIPTION OPTION MENU CREATE creates an option menu widget. The option 
menu widget is a composite widget containing a label identifying the menu 
and toggle buttons. The option menu allows the user to select only one 
option from the menu. It displays the current option selected and, on 
request, generates a pop-up menu with specific options available. The pop- 
up menu covers the current selection, but it displays the current selection 
as one of the options. 





If entry_callback is not null, then all the toggle button callbacks will 
execute the entry_callback routine, rather than the procedure specified 
in the toggle button. If entry_callback is null, then individual callbacks 
work as usual. 


An option menu widget can also be created with the high-level routine 


OPTION MENU. 
geometry See the low-level routine MENU CREATE. 
management 
resizing See the low-level routine MENU CREATE. 
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PULL DOWN MENU ENTRY CREATE 


Creates a pull-down menu entry widget. 





WIDGET CLASS 
HIERARCHY sid 
\ 
composite 
\ 
common 
\ 
label 
\ 


pulldown menu entry 





VAX FORMAT ~~ widget = DWT$PULL_DOWN_MENU_ENTRY_CREATE 
(parent_widget, name, override_arglist, 
override_argcount) 


argument 


information Argument —« Usage ~=—SCS ata Type =———sAccess_— Mechanism 


widget - widget uns longword write value 
parent_widget widget uns longword read reference 
name char string char string read descriptor 
override_arglist arglist uns longword read reference 
override_argcount —_ uns longword uns longword read reference 
attribute The following widget-specific attributes can be set in the override_ 
information arglist: 
Argument Usage Data Type Access Mechanism 
sub_menu_id widget uns longword read reference 
activate_callback callback uns longword read reference 
pulling_callback callback uns longword read reference 
hot_spot_pixmap pixmap uns longword read value 
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MIT C FORMAT 


argument 
information 


attribute 
information 


widget = DwtPullDownMenuEntryCreate 
(parent_widget, name, override_arglist, 
override_argcount) 


Widget DwtPullDownMenuEntryCreate (parent _widget, name, 
override _arglist, 
override _argcount) 

Widget parent _widget; 


char *name; 
ArgList override_arglist; 
int override _argcount; 


The following widget-specific attributes can be set in the override_ 
arglist: 


Widget sub_menu_id; 
DwtCallbackPtr activate callback; 
DwtCallbackPtr pulling callback; 
Pixmap hot_spot_pixmap; 





RETURNS 


widget 
The identifier of the created widget. 





ARGUMENTS 


parent_widget 
The identifier of the parent widget. 


name 


The name of the created widget. 


override_arglist 


The application override argument list. 


override_argcount 


The number of arguments in the application override argument list. 





WIDGET- 
SPECIFIC 
ATTRIBUTES 
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sub_menu_id 
VAX binding: DWT$C_NSUB_MENU_ID 
C binding: DwtNsubMenuld 


The identifier of the submenu to be displayed when the pull-down menu is 
activated. The default is null. 


activate_callback 
VAX binding: DWT$C_NACTIVATE_CALLBACK 
C binding: DwtNactivateCallback 


A callback routine or routines called when the user releases a button 
inside the pull-down menu entry widget. The reason for this callback is 
Activated. The default is null. 


Low-Level Widget Routines 
PULL DOWN MENU ENTRY CREATE 


pulling_callback 
VAX binding: DWT$C_NPULLING_CALLBACK 
C binding: DwtNpullingCallback 


A callback routine or routines called just prior to pulling down the 
submenu. This callback occurs just before the submenu’s map callback. 
This callback can be used for deferred creation of the submenu. The 
reason for this callback is Activated. The default is null. 


hot_spot_pixmap 
VAX binding: DWT$C_NHOT_SPOT_PIXMAP .- 
C binding: DwtNhotSpotPixmap 


The pixmap to use for the hotspot icon. The default is null. 








ATTRIBUTE The following common attributes are supported differently by PULL 
EXCEPTIONS DOWN MENU ENTRY CREATE: 
¢ The default for width equals the label width, plus the hotspot width, 
plus 2 times margin_width. 
¢ The default for height equals the text label or pixmap label height 
plus 2 times margin_height. 
e The default for border_width equals 0 pixels. 
CALLBACK 
DATA 31 0 
STRUCTURE 
ZK-0091A-GE 
VAX field Structure name: DWT$ANY_CB_ST 
information 
Name Usage Data Type Access Mechanism 
any_reason callback reason longword read value 
_ any_event event uns longword read reference 


MIT C field 
information 


typedef struct { 
int reason; 
XEvent *event; 

} DwtAnyCallbackStruct; 
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CALLBACK reason 
FIELD An integer set to the callback reason. See the Callback Reasons section for 


the values applicable to this widget. 
DESCRIPTIONS 
event 


A pointer to the X event structure describing the event that generated this 
callback. 





CALLBACK eee : 
VAX binding: DWT$C_CRACTIVATED 
REASONS Cc bude DwtCRActivated 


The user selected the pull-down menu entry. 


Help Requested 
VAX binding: DWT$C_CRHELP_REQUESTED 
C binding: DwtCRHelpRequested 


The user selected help. 





DESCRIPTION PULL DOWN MENU ENTRY CREATE creates a pull-down menu entry 
widget. A pull-down menu entry widget is made up of two parts: a label 
(within the parent menu) and a select area or hotspot. In menu bars and 
work menus the hotspot is the full widget window. Otherwise, the hotspot 
is a separate rectangle on the right side of the entry label. A pull down 
menu entry widget can also be created with the high-level routine PULL 


DOWN MENU ENTRY. 
geometry The pull-down menu entry widget can have a push button child, the 
management hotspot widget. This is the only child it allows. The pull-down menu entry 


widget does not accept any geometry management requests. 


resizing When the pull-down menu entry widget is resized by its parent, it lays out 
its label and then repositions and resizes the hotspot widget. 
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PUSH BUTTON CREATE 


Creates a push button widget. 





- WIDGET CLASS 
HIERARCHY ae 
\ 
composite 
\ 
common 
\ 
label 


: 
push button 





VAX FORMAT _ widget = DWT$PUSH_BUTTON_CREATE 
(parent_widget, name, override_arglist, 
override_argcount) 


argument 

information Argument Usage Data Type Access Mechanism 
widget widget uns longword write value 
parent_widget widget uns longword read reference 
name char string char string read descriptor 
override_arglist arglist uns longword read reference 
override_argcount uns longword uns longword read reference 

attribute The following widget-specific attributes can be set in the override_ 

information arglist: 
Attribute Usage Data Type Access Mechanism 
border_highlight Boolean uns byte read value 
fill_highlight Boolean uns byte read value 
activate_callback callback uns longword read reference 
arm_callback callback uns longword read reference 
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Attribute Usage Data Type Access Mechanism 
disarm_callback callback uns longword read reference 
accelerator_text comp string uns longword read reference 
button_accelerator char string uns longword read reference 
shadow Boolean uns byte read value 





MIT C FORMAT 


argument 
information 


attribute 
information 


widget = DwtPushButtonCreate 
(parent_widget, name, override_arglist, 
override_argcount) 


Widget DwtPushButtonCreate (parent widget, name, override _arglist, 
override_argcount) 
Widget parent _widget; 
char *xname; 
ArgList override_arglist; 
int override argcount; 


The following widget-specific attributes can be set in the override_ 
arglist: 


Boolean border highlight; 
Boolean fill highlight; 
DwtCallbackPtr activate callback; 
DwtCallbackPtr arm callback; 
DwtCallbackPtr disarm callback; 
DwtCompString accelerator text; 
char *button_accelerator; 
Boolean shadow; 





RETURNS 


widget 
The identifier of the created widget. 





ARGUMENTS 
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parent_widget 
The identifier of the parent widget. 


name 
The name of the created widget. 


override_arglist 


The application override argument list. 


override_argcount 
The number of arguments in the application override argument list. 


Low-Level Widget Routines 
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WIDGET- 
SPECIFIC 
ATTRIBUTES 


border_highlight 
VAX binding: DWT$C_NBORD_HIGHLIGHT 
C binding: DwtNbordHighlight 


A Boolean attribute that specifies whether the border is highlighted. The. 
highlighting is a 1-pixel line inside the border window. If true, the border 
is highlighted. The default is false. 


fill_highlight 
VAX binding: DWT$C_NFILL_HIGHLIGHT 
C binding: DwtNfillHighlight 


A Boolean attribute that specifies whether the border of the button is 
filled. If true, displays the border of the button in reverse video. The 
default is false. 


activate_callback 
VAX binding: DWT$C_NACTIVATE_CALLBACK 
C binding: DwtNactivateCallback 


The callback routine or routines called when the push button is activated. 
The button is activated when the user presses and releases MB1 while 
the pointer is inside the push button widget. Activating the push button 
also disarms the push button. See disarm_callback. The reason for this 
callback is Activated. The default is null. 


arm_callback 
VAX binding: DWT$C_NARM_CALLBACK 
C binding: DwtNarmCallback 


The callback routine or routines called when the push button is armed. 
The button is armed when the user presses MB1 while the pointer is 
inside the push button widget. The reason for this callback is Arm. 


disarm_callback 
VAX binding: DWT$C_NDISARM_CALLBACK 
C binding: DwtNdisarmCallback 


The callback routine or routines called when the push button is disarmed. 
The button is disarmed in two ways. After the user activates the button 
(presses and releases MB1 while the pointer is inside the push button 
widget), the button is disarmed. When the user presses MB1 while the 
pointer is inside the push button widget but moves the pointer outside the 
push button before releasing MB1, the button is disarmed. The reason for 
this callback is Disarm. The default is null. 


accelerator_text 
VAX binding: DWT$C_NACCELERATOR_TEXT 
C binding: DwtNacceleratorText 


The text to be displayed for the accelerator. The default is null. 
button_accelerator 


VAX binding: DWT$C_NBUTTON_ACCELERATOR 
C binding: DwtNbuttonAccelerator 
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An accelerator on a push button widget. The same as the common 
argument translations except that only the left side of the table is 
passed as a character string, not compiled. The application is responsible 
for calling the intrinsic routine INSTALL ALL ACCELERATORS to install 
the accelerator where the application needs it. See the VMS DECwindows 
Guide to Application Programming for information on translation tables. 
The default is null. 


shadow 
VAX binding: DWT$C_NSHADOW 
C binding: DwtNshadow 


Determines whether the shadow of the push button is displayed. The 
default is true. 





ATTRIBUTE The following common attributes are supported differently by PUSH 
EXCEPTIONS BUTTON CREATE: 


¢ The default for width equals the width of the label or pixmap plus 2 
times margin_width. 


e The default for height equals the height of the label or pixmap plus 2 
times margin_height. 


e The default for border_width equals 1 pixel. 









CALLBACK 
DATA 31 0 
STRUCTURE 
ZK-0091A-GE 
VAX field Structure name: DWT$ANY_CB_ST 
information 
. Name Usage Data Type Access Mechanism 
any_reason callback reason longword read value 
any_event event | uns longword read reference 


MIT C field 
information typedef struct { 


int reason; 
XEvent *event; 
} DwtAnyCallbackStruct; 


8-120 


Low-Level Widget Routines 
PUSH BUTTON CREATE 





CALLBACK reason 


FIELD An integer set to the callback reason. See the Callback Reasons section for 
the values applicable to this widget. 

DESCRIPTIONS 
event 
A pointer to the X event structure describing the event that generated this 
callback. 





CALLBACK pelvaiee ; 
VAX binding: DWT$C_CRACTIVATED 
REASONS Cc hacia | DwtCRActivated 


The user activated the push button by pressing and releasing MB1 while 
the pointer was inside the push button widget. 


Arm 
VAX binding: DWT$C_CRARM 
C binding: DwtCRArm 


The user armed the push button by pressing MB1 while the pointer was 
inside the push button widget. 


Disarm 
VAX binding: DWT$C_CRDISARM 
C binding: DwtCRDisarm 


The user disarmed the push button in one of two ways. The user pressed 
MBI1 while the pointer was inside the push button widget, but did not 
release it until after moving the pointer outside the push button widget. 
Alternately, the user activated the push button which simultaneously 
disarms it. 


Help Requested 
VAX binding: DWT$C_CRHELP_REQUESTED 
C binding: DwtHelpRequested 


The user selected help. 





DESCRIPTION i $=PUSH BUTTON CREATE creates a push button widget. The push button 
is a primitive widget that displays a rectangular border around a label. 
The label defines the immediate action of the button function (for example, 
OK or Cancel in a dialog box). 


The sizing is affected by the spacing, the font, and the label. See the 
LABEL WIDGET routine for more information. A push button widget can 
also be created with the high-level routine PUSH BUTTON. 


geometry The push button widget follows the same rules for geometry management 
management as its superclass the label widget, described in the low-level routine 
LABEL CREATE. 
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resizing The push button widget follows the same rules for resizing as its 
superclass the label widget, described in the low-level routine LABEL 
CREATE. 
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RADIO BOX CREATE 


Creates a radio box widget. 





WIDGET CLASS 
HIERARCHY are 
eanacais 
sae 
ae box 





VAX FORMAT ~~ widget = DWT$RADIO_BOX_CREATE 
(parent_widget, name, override_arglist, 
override_argcount) 


argument 

information Argument Usage Data Type © Access Mechanism 
widget widget uns longword write value 
parent_widget widget uns longword read reference 
name char string char string read descriptor 
override_arglist arglist uns longword read reference 
override_argcount — uns longword uns longword read reference 


Attributes described in the low-level routine MENU CREATE can be set in 
the override_arglist. 





MIT C FORMAT widget = DwtRadioBoxCreate 
(parent_widget, name, override_arglist, 
override_argcount) 


argument 
information Widget DwtRadioBoxCreate(parent_widget, name, override_arglist, 
override argcount) 
Widget parent widget; 
char xname; _ 
ArgList override arglist; 
int override argcount; 


Attributes described in the low-level routine MENU CREATE can be set in 
the override_arglist. 
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RETURNS widget 


The identifier of the created widget. 





ARGUMENTS _ parent_widget 
The identifier of the parent widget. 


name 


The name of the created widget. 


override_arglist 


The application override argument list. 


override_argcount 


The number of arguments in the application override argument list. 








WIDGET- See the widget-specific attributes for the low-level routine MENU 
SPECIFIC an 

ATTRIBUTES 

ATTRIBUTE The following common attributes are supported differently by RADIO BOX 


EXCEPTIONS CBEATE: 


e The defaults for width and height are set as large as necessary to 
hold all widgets. 


¢ Setting the sensitivity causes all widgets contained in the radio box to 
be set to the same sensitivity. 










CALLBACK 
DATA 31 0 
STRUCTURE 


ZK-0094A-GE 
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VAX field 


information 


MIT C field 
information 


Low-Level Widget Routines 
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Structure name: DWT$RADIOBOX_CB_ST 


Name Usage Data Type Access Mechanism 


radiobox_reason callback §longword read value 
reason 

radiobox_event event uns longword read reference 

radiobox_s_widget widget longword read reference 

radiobox_s_tag longword uns longword read value 

radiobox_s_callbackstruct callback — uns longword read reference 


typedef struct { 


int reason; 

XEvent *event; 

int s_widget; 

char *s tag; 

char *s callbackstruct 


} DwtRadioBoxCallbackStruct; 





CALLBACK 


FIELD 


DESCRIPTIONS 


reason 
An integer set to the callback reason. See the Callback Reasons section for 
the values applicable to this widget. 


event 
A pointer to the X event structure describing the event that generated this 
callback. 


s_ widget 
The identifier of the calling subwidget. 
Ss_ tag 


The tag supplied by the application programmer when the callback routine 
was specified. 


s_callbackstruct 
The subwidget’s callback structure. 





CALLBACK 
REASONS 


Value Changed 
VAX binding: DWT$C_CRVALUE_CHANGED 
C binding: DwtCRValueChanged 


The user activated the toggle button or push button. 


Map 
VAX binding: DWT$C_CRMAP 
C binding: DwtCRMap 


The radio box is about to be mapped. 
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Help Requested 
VAX binding: DWT$C_CRHELP_REQUESTED 
C binding: DwtCRHelpRequested 


The user selected help. 





DESCRIPTION 


geometry 
management 


resizing 
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RADIO BOX CREATE creates a radio box widget. The radio box is a 
composite widget that contains multiple toggle button widgets. The radio 
box ensures that only one toggle button is on at any given time. 


A radio box widget can also be created with the high-level routine RADIO 
BOX. 


See the low-level routine MENU CREATE. 


See the low-level routine MENU CREATE. 
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SCALE CREATE 


Creates a scale widget. 





WIDGET CLASS 
HIERARCHY bore 
ere 
common 
scale 





VAX FORMAT ~ widget =DWT$SCALE_CREATE 
(parent_widget, name, override_arglist, 
override_argcount) 


argument 

information Argument Usage Data Type Access Mechanism 
widget widget uns longword write value 
parent_widget widget uns longword read reference 
name char string char string read descriptor 
overrride_arglist arglist uns longword read reference 
override_argcount uns longword uns longword read reference 

attribute The following widget-specific attributes can be set in the override_ 

information arglist: 
Argument Usage Data Type Access Mechanism 
value longword longword read value 
title comp string uns longword read reference 
orientation uns byte uns byte read value 
scale_width dimension uns word read value 
scale_height dimension uns word read value 
min_value longword longword read value 
max_value longword longword read value 
decimal_points uns word uns word read value 
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Argument Usage Data Type Access Mechanism 
show_value Boolean uns byte read value 
slider_pixmap pixmap uns longword read value 
drag_callback callback uns longword read reference 
value_changed_callback callback uns longword read reference 





MIT C FORMAT 


argument 
information 


attribute 
information 


widget = DwtScaleCreate 
(parent_widget, name, override_arglist, 
override_argcount) 


Widget DwtScaleCreate(parent_widget, name, override arglist, 
override argcount) 
Widget parent_widget; : 


char *xname; 
ArgList override _arglist; 
hie ta override argcount; 


The following widget-specific attributes can be set in the override_ 
arglist: 


int value; 
DwtCompString title; 
unsigned char orientation; 
Dimension scale width; 
Dimension scale height; 
int min_value; 

int max value; 
short decimal points; 
Boolean show_value; 
Pixmap slider pixmap; 


DwtCallbackPtr drag_callback; 
DwtCallbackPtr value _changed_callback; 





RETURNS 


widget 
The identifier of the created widget. 





ARGUMENTS 
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parent_widget 
The identifier of the parent widget. 


name 
The name of the created widget. 


override_arglist 


The application override argument list. 


override_argcount 


The number of arguments in the application override argument list. 
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WIDGET- 
SPECIFIC 
ATTRIBUTES 


value 
VAX binding: DWT$C_NVALUE 
C binding: DwtNvalue 


The value represented by the slider’s current position. The default is zero. 


title 
VAX binding: DWT$C_NTITLE 
C binding: DwtNtitle 


The title text string to appear in the scale window widget. The default is 
the scale name. 


orientation 
VAX binding: DWT$C_NORIENTATION 
C binding: DwtNorientation 


The orientation of the scale. The predefined values for this attribute are 
as follows: 


VAX Cc Description 
DWT$C_ORIENTATION_ —_ DwtOrientationHorizontal Horizontal scale (default) 
HORIZONTAL 

DWT$C_ORIENTATION__ DwtOrientationVertical Vertical scale 
VERTICAL 


scale_width 
VAX binding: DWT$C_NSCALE_WIDTH 
C binding: DwtNscaleWidth 


The width of the scale (excluding labels). The default is 20 pixels for 
vertical scales and is calculated for horizontal scales. 


scale_height 
VAX binding: DWT$C_NSCALE_HEIGHT 
C binding: DwtNscaleHeight 


The height of the scale (excluding labels). The default is 20 pixels for 
horizontal scales and is calculated for vertical scales. 


min_value 
VAX binding: DWT$C_NMIN_VALUE 
C binding: DwtNminValue 


The value represented by the top or left end of the scale. The default is 
Zero. 


max_value 
VAX binding: DWT$C_NMAX_VALUE 
C binding: DwtNmaxValue 


The value represented by the bottom or right end of the scale. The default 
is 100. 
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decimal_points 
VAX binding: DWT$C_NDECIMAL_POINTS 
C binding: DwtNdecimalPoints 


The number of decimal points to shift the current slider value for display 
next to the slider. The default is zero. 


show_value 
VAX binding: DWT$C_NSHOW_VALUE 
C binding: DwtNshowValue 


A Boolean attribute that, when true, states that the current value of the 
slider label string will be displayed next to the slider. The default is true. 


slider_pixmap 
VAX binding: DWT$C_NSLIDER_PIXMAP 
C binding: DwtNsliderPixmap 


The pixmap for the slider. The default is null, with an arrow being 
displayed. 


drag_callback 
VAX binding: DWT$C_NDRAG_CALLBACK 
C binding: DwtNdragCallback 


The callback routine or routines called because the user is dragging the 
slider. For this routine, the callback reason is Drag. 


value_changed_callback 
VAX binding: DWT$C_NVALUE_CHANGED_CALLBACK 
C binding: DwtNvalueChangedCallback 


The callback routine or routines called when the value of the slider 
changes. For this routine, the callback reason is Value Changed. 





ATTRIBUTE The following common attributes are supported differently by SCALE 
EXCEPTIONS CREATE: 


¢ The defaults for width and height are calculated based on the scale 
width or height, the label widths, and the orientation. 


¢ The default for border_width is 0 pixels. 








CALLBACK 
DATA 31 0 
STRUCTURE 


ZK-0096A-GE 
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VAX field 
information 
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Structure name: DWT$SCALE_CB_ST 


Name Usage Data Type Access Mechanism 
sc_reason callback reason longword read value 
sc_event event uns longword read reference 
sc_value longword longword read value 








MIT C field 
information EYPECGE SSUEUCE «4 
int reason; 
XEvent *event; 
int value; 
} DwtScaleCallbackStruct; 
CALLBACK reason ; 
FIELD An integer set to the callback reason. See the Callback Reasons section for 
the values applicable to this widget. 
DESCRIPTIONS 
event . 
A pointer to the X event structure describing the event that generated this 
callback. 
value 
The current value of the scale. 
CALLBACK Value Changed 
REASONS VAX binding: DWT$C_CRVALUE_CHANGED 


C binding: DwtCRValueChanged 


The user moved the slider in the scale by dragging it or clicking on it, or 
the intrinsic routine SET VALUES changed the value of the slider. 


Drag 
VAX binding: DWT$C_CRDRAG 
C binding: DwtCRDrag 


The user is dragging the slider. 


Help Requested 
VAX binding: DWT$C_CRHELP_REQUESTED 
C binding: DwtCRHelpRequested 


The user selected help. 
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DESCRIPTION 


geometry 
management 


resizing 


8-132 


SCALE CREATE creates a scale widget. The scale widget allows the 
application to display a scale for vernier control of a specific parameter by 
the user. The user places the slider at a position representing the desired 
value. The scale may have labeled text at any number of points identifying 
the values corresponding to the points. The scale can be made insensitive 
and used as an output value indicator only (for example, a thermometer or 
percent completion indicator). 


The application passes lower and upper values for the scale as integers 
and can (optionally) indicate a decimal point position. For example, a 
min_value of 100, a max_value of 10000, and a decimal_points of 2 
would produce a scale from 1.00 to 100.00. Possible values returned from 
this example could be 230 or 5783 (representing decimal values 2.30 and 
57.83). 


Tick mark labels along the scale are provided by the scale’s children. 
The labels can be any type of widget created with the scale widget as 
its parent. Normally a label widget is used. The order of creation of the 
widgets determines their placement along the scale. 


A scale widget can also be created with the high-level routine SCALE. 


The scale widget moves its children so they will be within the scale 
widget’s calculated size. DIGITAL recommends that you create the scale 
widget with width and height attributes set to zero. This allows the scale 
widget to make the best decisions for its layout. 


If resized, the scale widget positions its children so they all fit within the 
scale widget. 
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SCROLL BAR CREATE 


Creates a scroll bar widget. 





WIDGET CLASS 
HIERARCHY tec 
\ 
composite 
\ 
common 
\ 
scroll 





VAX laa widget = DWT$SCROLL_BAR_CREATE 
(parent_widget, name, override_arglist, 
override_argcount) 


argument 

information Argument Usage Data Type Access Mechanism 
widget widget uns longword write value 
parent_widget widget uns longword read reference 
name char string char string read descriptor 
override_arglist arglist uns longword read reference 
override_argcount — uns longword uns longword read reference 

attribute The following widget-specific attributes can be set in the override_ 

information arglist: 
Attribute Usage Data Type Access Mechanism 
int_value longword longword read value 
min_value longword longword read value 
max_value longword longword read value 
orientation uns byte uns longword read value 
translations1 translations uns longword read reference 
translations2 translations uns longword read reference 
shown longword longword read value 
ine longword longword read value 
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Attribute Usage Data Type Access Mechanism 
page_inc longword longword read value 
unit_inc_callback callback uns longword read reference 
unit_dec_callback callback uns longword read reference 
page_inc_callback callback uns longword read reference 
page_dec_callback callback uns longword read reference 
to_top_callback callback uns longword read reference 
to_bottom_callback callback uns longword read reference 
drag_callback callback uns longword read reference 
value_changed_ callback uns longword read reference 
callback 





MIT C FORMAT widget = DwtScrollBarCreate 
(oarent_widget, name, override_arglist, 
override_argcount) 


argument | 
information Widget DwtScrollBarCreate (parent _widget, name, override_arglist, 
override argcount) 
Widget parent_widget; 
char *name; 
ArgList override _arglist; 
int override _argcount; 
attribute The following widget-specific attributes can be set in the override_ 
information arglist: 
int int_value; 
int min_value; 
int max value; 


unsigned char orientation; 
XtTranslations translations1; 
XtTranslations translations2; 


int shown; 
int inc; 
int page_inc; 


DwtCallbackPtr unit_inc_callback; 
DwtCallbackPtr unit _dec_callback; 
DwtCallbackPtr page inc callback; 
DwtCallbackPtr page _dec_callback; 
DwtCallbackPtr to top callback; 
DwtCallbackPtr to_bottom_callback; 
DwtCallbackPtr drag callback; 
DwtCallbackPtr value_changed_callback; 


8-134 


Low-Level Widget Routines 
SCROLL BAR CREATE 





RETURNS 


widget 
The identifier of the created widget. 





ARGUMENTS 


parent_widget 
The identifier of the parent widget. 


name 


The name of the created widget. 


override_arglist 
The application override argument list. 


override_argcount 
The number of arguments in the application override argument list. 





WIDGET- 
SPECIFIC 
ATTRIBUTES 


int_value 
VAX binding: DWT$C_NVALUE 
C binding: DwtNvalue 


The position of the top or left end of the scroll bar’s slider. The default is 
zero. 


min_value 
VAX binding: DWT$C_NMIN_VALUE 
C binding: DwtNminValue 


The scroll bar’s minimum value. The default is zero. 
max_value 


VAX binding: DWT$C_NMAX_VALUE 
C binding: DwtNmaxValue 


The scroll bar’s maximum value. The default is 100. 
orientation 


VAX binding: DWT$C_NORIENTATION 
C binding: DwtNorientation 


The orientation of the scroll bar. The predefined values for this attribute 
are as follows: 


VAX Cc Description 
DWT$C_ORIENTATION_ DwtOrientationHorizontal Horizontal scroll bar 
HORIZONTAL 


DWT$C_ORIENTATION_ DwtOrientationVertical Vertical scroll bar (defauit) 
VERTICAL 


translations! 
VAX binding: DWT$C_NTRANSLATIONS1 
C binding: DwtNtranslationsl 
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The translation table for events after being parsed by the intrinsic routine 
PARSE TRANSLATION TABLE for the decrement stepping arrow. See the 
VMS DECwindows Guide to Application Programming for information on 
translation tables. The default is null. 


translations2 
VAX binding: DWT$C_NTRANSLATIONS2 
C binding: DwtNtranslations2 


The translation table for events after being parsed by PARSE 
TRANSLATION TABLE for the increment stepping arrow. See the VMS 
DECwindows Guide to Application Programming for information on 
translation tables. The default is null. 


shown 
VAX binding: DWT$C_NSHOWN 
C binding: DwtNshown 


The size of the slider as value between zero and the absolute value of 
max_value minus min_value. The size of the slider varies, depending on 
how much of the slider scroll area it represents. The default is 10 units. 


ine 
VAX binding: DWT$C_NINC 
C binding: DwtNinc 


The amount of unit increment and decrement. The default is 10 units. 
If this argument is not zero, the widget automatically adjusts the slider 
when a increment/decrement action occurs. 


page_inc 
VAX binding: DWT$C_NPAGE_INC 
C binding: DwtNpagelnc 


The amount of page increment and decrement. The default is 10 units. 
If this argument is not zero, the widget automatically adjusts the slider 
when an increment/decrement action occurs. 


unit_inc_callback 
VAX binding: DWT$C_NUNIT_INC_CALLBACK 
C binding: DwtNunitIncCallback 


The callback routine or routines called because the user selected the unit 
increment function. For this routine, the callback reason is Unit Inc. The 
default is null. 


unit_dec_callback 
VAX binding: DWT$C_NUNIT_DEC_CALLBACK 
C binding: DwtNunitDecCallback 


The callback routine or routines called because the user selected the unit 
decrement function. For this routine, the callback reason is Unit Dec. 
The default is null. 


page_inc_callback 
VAX binding: DWT$C_NPAGE_INC_CALLBACK 
C binding: DwtNpageIncCallback 
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The callback routine or routines called because the user selected the page 
increment function. For this routine, the callback reason is Page Inc. 
The default is null. 


page_dec_callback 
VAX binding: DWT$C_NPAGE_DEC_CALLBACK 
Cbinding: DwtNpageDecCallback 


The callback routine or routines called because the user selected the page 
decrement function. For this routine, the callback reason is Page Dec. 
The default is null. 


to_top callback 
VAX binding: DWT$C_NTO_TOP_CALLBACK 
C binding: DwtNtoTopCallback 


The callback routine or routines called because the user selected the to-top 
scroll function. For this routine, the callback reason is To Top. 


The scroll bar does not automatically change the scroll bar’s value for this 
callback. The default is null. 


to_bottom_callback 
VAX binding: DWT$C_NTO_BOTTOM_CALLBACK 
C binding: DwtNtoBottomCallback 


The callback routine or routines called because the user selected the 
to-bottom scroll function. For this routine, the callback reason is To 
Bottom. 


The scroll bar does not automatically change the scroll bar’s value for this 
callback. The default is null. 


drag_ callback 
VAX binding: DWT$C_NDRAG_CALLBACK 
C binding: DwtNdragCallback 


The callback routine or routines called because the user is dragging the 
scroll bar slider. For this routine, the callback reason is Drag. The default 
is null. 


value_changed_callback 
VAX binding: DWT$C_NVALUE_CHANGED_CALLBACK 
C binding: DwtNvalueChangedCallback 


The callback routine or routines called when the value of the scroll has 
changed. For this routine, the callback reason is Value Changed. The 
default is null. 





ATTRIBUTE 
EXCEPTIONS 


The following common attributes are supported differently by SCROLL 
BAR CREATE: 


¢ The default for width is 17 pixels for a vertical orientation, and the 
width of the parent minus 17 pixels for a horizontal orientation. 


e The default for height is 17 pixels for a horizontal orientation, and 
the height of the parent minus 17 pixels for a vertical orientation. 


e The font attribute is not supported. 
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CALLBACK 
DATA 31 0 
STRUCTURE [mani 
ZK-0253A-GE 
VAX field Structure name: DWT$SCRL_BAR_CB_ST 
information 
Name Usage Data Type Access Mechanism 
scroll_reason callback reason longword read value 
scroll_event event uns longword read reference 
scroll_value longword longword read value 
scroll_pixel longword longword read value 
MIT C field 
information pee ery A 
int reason; 
XEvent *event; 
int value; 
ac pixel; 
} DwtScroliBarCallbackStruct; 
CALLBACK reason 
FIELD An integer set to the callback reason. See the Callback Reasons section for 
the values applicable to this widget. 
DESCRIPTIONS 
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event 


A pointer to the X event structure describing the event that generated this 
callback. 


value 

The current scroll bar value. 

pixel 

The pixel distance from the top right of the scroll bar (for vertical scroll 
bars) or from the left of the scroll bar (for horizontal scroll bars) where the 


event occurred. This value is used for the to_top_callback and 
to_bottom_callback attributes. 
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CALLBACK 
REASONS 


Value Changed | 
VAX binding: DWT$C_CRVALUE_CHANGED 
C binding: DwtCRValueChanged 


The user changed the value of the scroll bar slider, or the intrinsic routine 
SET VALUES changed the value of the scroll bar slider. 


Unit Ine 
VAX binding: DWT$C_CRUNIT_INC 
C binding: DwtCRUnitiInc 


The user selected the unit increment function. 
Unit Dec 


VAX binding: DWT$C_CRUNIT_DEC 
C binding: DwtCRUnitDec 


The user selected the decrement function. 


Page Inc 
VAX binding: DWT$C_CRPAGE_INC 
Chinding:: DwtCRPagelInc 


The user selected the page increment function. 
Page Dec 


VAX binding: DWT$C_CRUNIT_DEC 
C binding: DwtCRPageDec 


The user selected the page decrement function. 
To Top 


VAX binding: DWT$C_CRTO_TOP 
C binding: DwtCRToTop 


The user selected the to-top scroll function. 


To Bottom 
VAX binding: DWT$C_CRTO_BOTTOM 
C binding: DwtCRToBottom 


The user selected the to-bottom scroll function. 


Drag 
VAX binding: DWT$C_CRDRAG 
C binding: DwtCRDrag 


The user is dragging the scroll bar slider. 


Help Requested 
VAX binding: DWT$C_CRHELP_REQUESTED 
C binding: DwtCRHelpRequested 


The user selected help. 
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DESCRIPTION 


geometry 
management 


resizing 


8-140 


SCROLL BAR CREATE creates a scroll bar widget. The scroll bar widget 
is a screen object that allows the user to scroll through display data too 
large for the screen. The scroll bar widget consists of two stepping arrows 
at either end of an elongated rectangle called the scroll region. The scroll 
region is overlaid with a slider bar that is adjusted in size and position as 
scrolling occurs. 


Users select the scrolling functions as follows: 


e Clicking MB1 on the right or bottom stepping arrow selects the unit 
increment function. 


e¢ Clicking MB1 on the left or top stepping arrow selects the unit 
decrement function. 


¢ Clicking MB1 on the scroll region between the slider and the right or 
bottom stepping arrow selects the page increment function. 


¢ Clicking MB1 on the scroll region between the slider and the left or 
top stepping arrow selects the page decrement function. 


¢ Clicking MB2 anywhere within the scroll bar selects the to-top 
function. 


¢ Clicking MB3 anywhere within the scroll bar selects the to-bottom 
function. 


The to_top_callback and to_bottom_callback attributes do not 
automatically set the slider as the other callbacks do. 


A scroll bar widget can also be created with the high-level routine 


SCROLL BAR. 


The scroll bar widget does not support children. 


If the core widget attribute width or height is set to zero, a default value 
is used. The default value varies with the orientation of the scroll bar and 
the attribute set to zero. 


The following are the defaults for vertical scroll bars: 
e Ifx is zero, x becomes the width of the parent widget minus 17 pixels. 


¢ If height is zero, height becomes the height of the parent widget 
minus 17 pixels. 


¢ If width is zero, width becomes 17 pixels. 


The following are the defaults for horizontal scroll bars: 
¢ Ify is zero, y becomes the height of the parent widget minus 17 pixels. 


¢ If width is zero, width becomes the width of the parent widget minus 
17 pixels. 


e If height is zero, the height becomes 17 pixels. 
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SCROLL WINDOW CREATE 


Creates a scroll window widget. 





WIDGET CLASS 
HIERARCHY ae 
\ 
composite 
\ 
common 


\ . 
scroll window 





VAX FORMAT ~~ _— widget = DWT$SCROLL_WINDOW_CREATE 
(parent_widget, name, override_arglist, 
override_argcount) 


argument 

information Argument Usage Data Type Access Mechanism 
widget widget uns longword write value 
parent_widget widget uns longword read reference 
name char string char string read descriptor 
override_arglist arglist uns longword read reference 
override_argcount uns longword uns longword read reference 

attribute The following widget-specific attributes can be set in the override_ 

information arglist: 
Attribute Usage Data Type Access Mechanism 
h_scroll widget uns longword read value 
v_scroll widget uns longword read value 
work_window widget uns longword read value 
shown_value__ Boolean uns byte read value 


automatic_horiz 


shown_value_ Boolean uns byte read value 
automatic_vert 
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MIT C FORMAT 


argument 
information 


attribute 
information 


widget = DwtScrollWindowCreate 
(parent_widget, name, override_arglist, 
override_argcount) 


Widget DwtScrollWindowCreate (parent widget, name, 
override_arglist, override_argcount) 
Widget parent widget; 
char *xname; 
ArgList override _arglist; 
int override _argcount; 


The following widget-specific attributes can be set in the override_ 
arglist: 


Widget h.scroll; 

Widget Vv seroli; 

Widget work window; 

Boolean shown_value_automatic_horiz; 
Boolean shown_value_automatic_vert; 





RETURNS 


widget 
The identifier of the created widget. 





ARGUMENTS 


parent_widget 
The identifier of the parent widget. 


name 
The name of the created widget. 


override_arglist 


The application override argument list. 


override_argcount 


The number of arguments in the application override argument list. 





WIDGET- 
SPECIFIC 
ATTRIBUTES 
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h_scroll 
VAX binding: DWT$C_NHORIZONTAL_SCROLL_BAR 
C binding: DwtNhorizontalScrollBar 


The widget identifier for the horizontal scroll bar in the scroll window 
widget. This cannot be supplied at main window creation time, but it can 
be set or specified after creation. The default is null. 
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v_scroll 
VAX binding: DWT$C_NVERTICAL_SCROLL_BAR 
C binding: DwtNverticalScrollBar 


The widget identifier for the vertical scroll bar in the scroll window widget. 
This cannot be supplied at main window creation time, but it can be set or 
specified after creation. The default is null. 


work_window 
VAX binding: DWT$C_NWORK_WINDOW 
C binding: DwtNworkWindow 


The widget identifier for the window to be associated with the scroll 
window work area. This cannot be supplied at main window creation time, 
but it can be set or specified after creation. The default is null. 


shown_value_automatic_horiz 
VAX binding: DWT$C_NSHOWN_VALUE_AUTOMATIC_HORIZ 
C binding: DwtNshownValueAutomaticHoriz 


A Boolean attribute that specifies whether the horizontal scroll bar’s 
shown value is automatically set. If true, the horizontal scroll bar’s shown 
value is automatically set. The default is true. 


shown_value_automatic_vert 
VAX binding: DWT$C_NSHOWN_VALUE_AUTOMATIC_VERT 
C binding: DwtNshownValueAutomaticVert 


A Boolean attribute that specifies whether the vertical scroll bar’s shown 
value is automatically set. If true, the vertical scroll bar’s shown value is 
automatically set. The default is true. 





ATTRIBUTE 
EXCEPTIONS 


The following common attributes are supported differently by SCROLL 
WINDOW CREATE: 


e Setting the sensitivity of the scroll window causes all widgets 
contained in that window to be set to the same sensitivity as the 
scroll window. 


¢ The font, and help_callback common attributes are not supported. 





DESCRIPTION 


SCROLL WINDOW CREATE creates the scroll window widget that 
provides a more direct interface for applications with scroll bars. It is 

a composite widget that can contain both vertical and horizontal scroll bar 
widgets and any widget as the window region. Scroll bar positioning and 
scroll bar slider sizes are automatically maintained. The scroll window 
widget simplifies programming by allowing programmers to create an 
application with scroll bars directly in the scroll window widget work area. 


A scroll window widget can also be created using the high-level routine 
SCROLL WINDOW. 


See also the high-level routine SCROLL WINDOW SET AREAS. 
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geometry The scroll window widget does not size or position the work region widget. 
management The scroll window widget does size and position the scroll bars. 
resizing The scroll window widget automatically resizes the scroll bars, but not the 


work region widget. 
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SELECTION CREATE 


Creates a selection widget. 





WIDGET CLASS 
HIERARCHY Gare 
\ 
composite 
\ 
constraint 
\ 
dialog 
\ 
selection 





VAX FORMAT _ widget = DWT$SELECTION_CREATE 
(parent_widget, name, override_arglist, 
override_argcount) 


argument 

information Argument Usage Data Type Access Mechanism 
widget widget uns longword write value 
parent_widget widget uns longword read reference 
name char string char string read descriptor 
override_arglist arglist uns longword read reference 
override_argcount uns longword uns longword read reference 

attribute The following widget-specific attributes can be set in the override_ 

information arglist: 
Attribute Usage Data Type Access Mechanism 
label comp string uns longword read reference 
value comp string uns longword read reference 
selection_label comp string uns longword read reference 
ok_label comp string uns longword read reference 
cancel_label comp string uns longword read reference 
activate_callback callback uns longword ___—si read reference 
cancel_callback callback uns longword read reference 
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Attribute Usage Data Type Access Mechanism 
no_match_callback callback uns longword read reference 
visible_item_count —longword longword read value 

items array uns longword read reference 
item_count longword longword read value 
must_match Boolean uns byte read value 





MiT C FORMAT 


argument 
information 


widget = DwtSelectionCreate 
(parent_widget, name, override_arglist, 
override_argcount) 


Widget DwtSelectionCreate(parent_widget, name, override _arglist, 


override argcount) 


Widget parent widget; 
char *name; 

ArgList override _arglist; 
int override argcount; 








attribute The following widget-specific attributes can be set in the override_ 
information arglist: 
DwtCompString label; 
DwtCompString value; 
DwtCompString selection label; 
DwtCompString ok_label; 
DwtCompString cancel label; 
DwtCallbackPtr activate_callback; 
DwtCallbackPtr cancel_callback; 
DwtCallbackPtr no_match_callback; 
int visible item_count; 
DwtCompString xitems; 
int item count; 
- Boolean must_match; 
RETURNS widget 
The identifier of the created widget. 
ARGUMENTS _ parent_widget 
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The identifier of the parent widget. 


name 
The name of the created widget. 


override_arglist 


The application override argument list. 
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override_argcount 
The number of arguments in the application override argument list. 





WIDGET- 
SPECIFIC 
ATTRIBUTES 


label 
VAX binding: DWT$C_NLABEL 
C binding: DwtNlabel 


The label to appear above the list box containing the items. The default is 
“Items”. 


value 
VAX binding: DWT$C_NVALUE 
C binding: DwtNvalue 


The current value of the selection widget displayed in the text edit field. 
The default is the null string. 


selection_label 
VAX binding: DWT$C_NSELECTION_LABEL 
C binding: DwtNselectionLabel 


The label above the selection text entry field. The default is “Selection”. 


ok_label 
VAX binding: DWT$C_NOK_LABEL 
C binding: DwtNokLabel 


The label for the OK push button. If the label is a null string, the button 
is not displayed. The default is “OK”. 


cancel_label 
VAX binding: DWT$C_NCANCEL_LABEL 
C binding: DwtNecancelLabel 


The label for the Cancel push button. If the label is a null string, the 
button is not displayed. The default is “Cancel”. 


activate_callback 
VAX binding: DWT$C_NACTIVATE_CALLBACK 
C binding: DwtNactivateCallback 


The callback routine or routines called when the user makes a selection. 
The reason for this callback is Activated. The default is null. 


cancel_callback 
VAX binding: DWT$C_NCANCEL_CALLBACK 
C binding: © DwtNeancelCallback 


The callback routine or routines called when the user cancels a selection. 
The reason for the callback is Cancel. The default is null. 


no_match_callback 
VAX binding: DWT$C_NNO_MATCH_CALLBACK 
C binding: DwtNnoMatchCallback 


The callback routine or routines called when must_match is true, and 
a user’s selection does not exactly match any items in the list box. The 
reason for this callback is No Match. The default is null. 
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visible_item_count 
VAX binding: DWT$C_NVISIBLE_ITEMS_COUNT 
C binding: DwtNvisibleItemsCount 


The number of items displayed in the selection widget’s list box. The 
default is 8 items. 


items 
VAX binding: DWT$C_NITEMS 


- Cbinding: DwtNitems 


The items in the selection widget’s list box. The default is null. 


item_count 
VAX binding: DWT$C_NITEMS_COUNT 
C binding: DwtNitemsCount 


The number of items in the selection widget’s list box. The default is zero. 


must_match 
VAX binding: DWT$C_NMUST_MATCH 
C binding; DwtNmustMatch 


A Boolean attribute that specifies whether the selection widget checks for 
an exact match. If true, the selection widget checks whether the user’s 
selection exactly matches an item in the list box. If there is not an exact 
match, the no_match_callback is activated. If there is an exact match, 
the activate_callback is activated. The default is false. 





ATTRIBUTE 
EXCEPTIONS 
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The following common attributes are supported differently by SELECTION 
CREATE: 


¢ The default for width is the width of the list box, plus the width of the 
push buttons, plus three times margin_width. The list box expands 
to accommodate items wider than the title. 


¢ The default for height is the height of the list box, plus the height 
of the text edit field, plus the height of the label, plus three times 
margin_height. 


¢ The default for x and y is centered in the parent window. 


The following attributes inherited from DIALOG BOX POPUP are 
supported differently: 


e ©The default for margin_width is 5 pixels. 
¢ The default for margin_height is 5 pixels. 
e The default for title is “Open”. 
¢ The default for style is Modal. 
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CALLBACK 
DATA 31 0 
STRUCTURE 
ZK-0095A-GE 
VAX field Structure name: DWT$SEL_CB_ST 
information bai 
Name Usage Data Type Access Mechanism 
sel_reason callback reason longword read value 
sel_event event uns longword read reference 
sel_value comp string uns longword read reference 
sel_value_len — longword longword read value 
MIT C field 
information EV Rceeh Srenees 
int reason; 
XEvent *x*event; 
DwtCompString value; 
int value _len; 


} DwtSelectionCallbackStruct; 





CALLBACK reason 
FIELD An integer set to the callback reason. See the Callback Reasons section for 


the values applicable to this widget. 
DESCRIPTIONS 
event 


A pointer to the X event structure describing the event that generated this 
callback. 


value 


The current selection when the callback occurred. 


value length 
The length of the selection compound string. 





CALLBACK ich lake ee ee Gakernn 
VAX binding: DWT$C_CRACTIVATED 
REASONS C binding: DwtCRActivated 
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The user activated the OK push button or double clicked on an item that 
has an exact match in the list box. 


No Match 
VAX binding: DWT$C_CRNO_MATCH 
C binding: DwtCRNoMatch 


The user activated the OK push button or double clicked on an item that 
does not have an exact match in the list box. 


Cancel 
VAX binding: DWT$C_CRCANCEL 
C binding: DwtCRCancel 


The user activated the Cancel button. 


Help Requested 
VAX binding: DWT$C_CRHELP_REQUESTED 
C binding; DwtCRHelpRequested 


The user selected help somewhere in the file selection box. 





DESCRIPTION 


geometry 
management 


resizing 
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SELECTION CREATE creates a selection widget. The selection widget is 
a pop-up dialog box containing a label widget, a text entry widget holding 
the current value, a list box displaying the current item list, and OK and 
Cancel push buttons. 


When realized, the selection widget displays the item list passed by the 
caller. The current value is displayed in the text entry field. Users make 
selections by clicking the mouse in the list box or by typing item names 
in the text entry field. The selection widget does not do file searches. Use 
FILE SELECTION to perform file searches. 


The selection widget follows the same rules for geometry management 

as its superclass the dialog box widget, described in the low-level routine 
DIALOG BOX POPUP CREATE. However, the selection widget allows only 
one child and places the child between the list box and the push buttons. 
That child cannot be a gadget. 


The selection widget follows the same rules for resizing as its superclass 
the dialog box widget, described in the low-level routine DIALOG BOX 
POPUP CREATE. 
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SEPARATOR CREATE 


Creates a separator widget. 





WIDGET CLASS 
HIERARCHY ae 
\ 
composite 
\ 
common 
\ 
label 
\ 
separator 





VAX FORMAT _ widget = DWT$SEPARATOR_CREATE 
(parent_name, name, override_arglist, 
override_argcount) 


argument 

information Argument Usage Data Type Access Mechanism 
widget widget uns longword write value 
parent_widget widget uns longword read reference 
name char string char string read descriptor 
override_arglist arglist uns longword read reference 
override_argcount uns longword uns longword read reference 

attribute The following widget-specific attributes can be set in the override_ 

information arglist: 
Attribute Usage Data Type Access Mechanism 
orientation uns byte uns longword read value 





MIT C FORMAT widget = DwtSeparatorCreate 
(parent_widget, name, override_arglist, 
override_argcount) 
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argument 
information Widget DwtSeparatorCreate (parent widget, name, override _arglist, 
override argcount) 
Widget parent_widget; 
char *xname; 
ArgList override _arglist; 
int override argcount; 
attribute The following widget-specific attributes can be set in the override_ 
information arglist: 
unsigned char orientation; 
RETURNS widget 
The identifier of the created widget. 
ARGUMENTS _ parent_widget 
The identifier of the parent widget. 
name 
The name of the created widget. 
override_arglist 
The application override argument list. 
override_argcount 
The number of arguments in the application override argument list. 
WIDGET- orientation 
VAX binding: DWT$C_NORIENTATION 
SPECIFIC C binding: DwtNorientation 
ATTRIBUTES 
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The orientation of the separator widget. The predefined values for this 
attribute are as follows: 


VMS Cc Description 
DWT$C_ORIENTATION_ DwtOrientationHorizontal Horizontal separator 
HORIZONTAL (default) 
DWT$C_ORIENTATION_ DwtOrientationVertical Vertical separator 
VERTICAL 


A separator widget draws a centered, single-pixel line between the 
appropriate margins. For example, a horizontal separator draws a 
horizontal line from the left margin to the right margin. It is placed 
vertically in the middle of the widget. 
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ATTRIBUTE The following common attributes are supported differently by 


EXCEPTIONS SEPARATOR CREATE: 
¢ The default width is 3 pixels. 


e The default height is 3 pixels. 
¢ The default for border_width is 0 pixels. 


¢ The translations, help_callback, and font attributes are not 
supported. 





DESCRIPTION SEPARATOR CREATE creates a separator widget. The separator widget 
is a screen object that allows the application to draw horizontal or vertical 
lines between items in a display. 


A separator widget can also be created with the high-level routine 


SEPARATOR. 
geometry Because a separator widget does not support children, it always refuses 
management geometry requests. 
resizing | The separator widget does nothing on a resize by its parents. 
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S TEXT CREATE 


Creates a simple text widget. 





WIDGET CLASS 





HIERARCHY Tre 
\ 
text 
\ 
s text 
VAX FORMAT | widget = DWT$S_TEXT_CREATE 


(parent_widget, name, override_arglist, 
override_argcount) 


argument 
information Argument Usage Data Type Access Mechanism 
widget widget uns longword write value 
parent_widget widget uns longword read reference 
name char string char string read descriptor 
override_arglist arglist uns longword read reference 
override_argcount —_ uns longword uns longword read reference 
attribute The following widget-specific attributes can be set in the override_ 
information arglist: 
Attribute Usage Data Type Access Mechanism 
margin_width dimension uns word read value 
margin_height dimension uns word read value 
cols uns longword —_uns longword read value 
rows uns longword uns longword read value 
top_position uns longword uns longword read value 
word_wrap Boolean uns byte read value 
scroll_vertical Boolean uns byte read value 
resize_height Boolean uns byte read value 
resize_width Boolean uns byte read value 
value char string char string read reference 
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Attribute 


editable 
max_len 
focus_callback 
help_callback 


lost_focus__ 
callback 


value_changed_ 
callback 


auto_show_insert_ 
point 
insertion_position 
foreground 

font 

blink_rate 
scroll_left_side 
insertion_point_ 
visible 
half_border 
pending_delete 
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Data Type 


Mechanism 


Usage Access 

Boolean uns byte read value 
uns longword uns longword read value 
callback uns longword read reference 
callback uns longword read reference 
callback uns longword read reference 
callback uns longword read reference 
Boolean uns byte read value 
uns longword uns longword read value 
pixel uns longword read value 
font list uns longword read reference 
uns longword uns longword read value 
Boolean uns byte read value 
Boolean uns byte read value 
Boolean uns byte read value 
Boolean uns byte read value 





MIT C FORMAT 


argument 
information 


attribute 
information 


widget = DwtSTextCreate 
(parent_widget, name, override_arglist, 
override_argcount) 


Widget DwtSTextCreate (parent widget, name, override_arglist, 


Widget 
char 
ArgList 
int 


override _argcount) 
parent widget; 
*name; 
override arglist; 
override argcount; 


The following widget-specific attributes can be set in the override_ 


arglist: 
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Dimension margin_width; 
Dimension margin_height; 
ant cols; 

int LOWS; 

int top_ position; 
Boolean word wrap; 
Boolean Scroll vertical; 
Boolean resize height; 
Boolean resize width; 
char *value; 
Boolean editable; 

int max_len; 


DwtCallbackPtr focus_callback; 
DwtCallbackPtr help callback; 
DwtCallbackPtr lost_focus_callback; 
DwtCallbackPtr value_changed_ callback; 











Boolean insertion point visible; 

Boolean auto_show_insert_point; 

int insertion position; 

Pixel foreground; 

FontList font; 

int blink rate; 

Boolean seroll: Left side; 

Boolean half border; 

Boolean pending delete; 
RETURNS widget 

The identifier of the created widget. 
ARGUMENTS _ parent_widget 

The identifier of the parent widget. 

name 

The name of the created widget. 

override_arglist 

The application override argument list. 

override_argcount 

The number of arguments in the application override argument list. 
WIDGET- margin_width 
SPECIFIC VAX binding: DWT$C_NMARGIN_WIDTH 

C binding: DwtNmarginWidth 
ATTRIBUTES i 
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The number of pixels between the left or right edge of the window and the 
text. The default is 2 pixels. 


margin_height 
VAX binding: DWT$C_NMARGIN_HEIGHT 
C binding: DwtNmarginHeight 


The number of pixels between the top or bottom edge of the window and 
the text. The default is 2 pixels. 
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cols 
VAX binding: DWT$C_NCOLS 
C binding: DwtNcols 


The width, in characters, of the window. The default is 20 characters. 


rows 
VAX binding: DWT$C_NROWS 
C binding: DwtNrows 


The height, in characters, of the window. The default is 1 character. 


top_position 
VAX binding: DWT$C_NTOP_POSITION 
C binding: DwtNtopPosition 


A position to display at the top of the window. The default is zero. 


word_wrap 
VAX binding: DWT$C_NWORD_WRAP 
C binding: DwtNwordWrap 


A Boolean attribute that specifies whether word wrap is set. If true, lines 
are broken at word breaks and text does not run off the right edge of the 
window. The default is false. 


scroll_vertical 
VAX binding: DWT$C_NSCROLL_VERTICAL 
C binding: DwtNscrollVertical 


A Boolean attribute that specifies whether a scroll bar is present. If true, 
adds a scroll bar that allows the user to scroll vertically through the text. 
The default is false. 


resize_height 
VAX binding: DWT$C_NRESIZE_HEIGHT 
C binding: DwtNresizeHeight 


A Boolean attribute that specifies whether the simple text widget resizes 
its height to accommodate all the text contained in the widget. If true, the 
simple text widget resizes its height and the text always displays starting 
from the first position in the source, even if instructed otherwise. This 
attribute is ignored if scroll_vertical is true. The default is true. 


resize_width 
VAX binding: DWT$C_NRESIZE_WIDTH 
C binding: DwtNresizeWidth 


A Boolean attribute that specifies whether the simple text widget resizes 
its width to accommodate all the text contained in the widget. If true, the 
simple text widget resizes its width. This argument is ignored if 
word_wrap is true. The default is true. 


value 
VAX binding: DWT$C_NVALUE 
C binding: DwtNvalue 


The text contents of the simple text widget. The default is the null string. 
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editable 
VAX binding: DWT$C_NEDITABLE 
C binding: DwtNeditable 


A Boolean attribute that, if true, specifies that the user is allowed to edit 
the text. The default is true. 


max_len | 
VAX binding: DWT$C_NMAX_ LENGTH 
C binding: DwtNmaxLength 


The maximum length of the text string in the simple text widget. The 
default is 22-1 


focus_callback 
VAX binding: DWT$C_NFOCUS_CALLBACK 
C binding: DwtNfocusCallback 


A callback routine or routines called when the simple text widget has 
accepted the input focus. The reason for this callback is Focus. The 
default is null. 


help_callback 
VAX binding: DWT$C_NHELP_CALLBACK 
C binding: DwtNhelpCallback 


The callback routine or routines called on a help request. The reason for 
this callback is Help Requested. The default is null. 


lost_focus_callback 
VAX binding: DWT$C_NLOST_FOCUS_CALLBACK 
C binding: DwtNlostFocusCallback 


The callback routine or routines called when the simple text widget loses 
input focus. The reason for this callback is Focus. The default is null. 


value_changed_callback 
VAX binding: DWT$C_NVALUE_CHANGED_CALLBACK 
C binding: DwtNvalueChangedCallback 


The callback routine or routines called when the value of the simple text 
widget changes. The reason for this callback is Value Changed. The 
default is null. 


insertion_point_visible 
VAX binding: DWT$C_NINSERTION_POINT_VISIBLE 
C binding: DwtNinsertionPointVisible 


A Boolean attribute that specifies whether the insertion point is marked by 
a blinking text cursor. If true, the insertion point is marked by a blinking 
text cursor. The default is true. 


auto_show_insert_point 
VAX binding: DWT$C_NAUTO_SHOW_INSERT_POINT 
C binding: DwtNautoShowInsertPoint 
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A Boolean attribute that, if true, ensures that the text visible in the simple 
text widget window contains the insertion point. This means that if the 
insertion point changes, the contents of the simple text widget window 
might scroll in order to bring the insertion point into the window. The 
default is true. 


insertion_position 
VAX binding: DWT$C_NINSERTION_POSITION 
C binding: DwtNinsertionPosition 


An integer indicating the current location of the insertion point. The 
default is zero. 


foreground 
VAX binding: DWT$C_NFOREGROUND 
C binding: DwtNforeground 


The pixel for the foreground of the simple text widget. The default is the 
current server default foreground. 


font 
VAX binding: DWT$C_NFONT 
C binding: DwtNfont 


The font list to be used for the simple text widget. The default is the 
current server font list. 


blink_rate 
VAX binding: DWT$C_NBLINK_RATE 
C binding: DwtNblinkRate 


An integer indicating the blink rate of the text cursor in milliseconds. The 
default is 500 milliseconds. 


scroll_left_side 
VAX binding: DWT$C_NSCROLL_LEFT_SIDE 
C binding: DwtNscrollLeftSide 


A Boolean attribute that, if true, indicates that the vertical scroll bar 
should be placed on the left side of the simple text window. This argument 
is ignored if the scroll_vertical attribute is false. The default is false. 


half_border 
VAX binding: DWT$C_NHALF_BORDER 
C binding: DwtNhalfBorder 


A Boolean attribute that, if true, specifies that a border is displayed only 
on the left and bottom edge of the simple text widget. The default is true. 


pending_delete 
VAX binding: DWT$C_NPENDING_DELETE 
C binding: DwtNpendingDelete 


A Boolean attribute that, if true, specifies that selected text containing the 
insertion point is deleted when new text is entered. The default is true. 
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ATTRIBUTE The following common attributes are supported differently by S TEXT 
EXCEPTIONS CSEATE: 


¢ The defaults for width and height are set as large as necessary to 
display the rows and columns with the given margin width and margin 

















height. 
CALLBACK 
DATA 31 0 
STRUCTURE 
ZK-0091A-GE 
VAX field Structure name: DWT$ANY_CB_ST 
information 
Name Usage Data Type Access Mechanism 
any_reason callback reason longword read value 
any_event event uns longword read reference 
MIT C field 
information FAS oe rays 
int reason; 
XEvent *event; 
} DwtAnyCallbackStruct; 
CALLBACK reason , 
FIELD An integer set to the callback reason. See the Callback Reasons section for 
the values applicable to this widget. 
DESCRIPTIONS 
event 
A pointer to the X event structure describing the event that generated this 
callback. 





CALLBACK Lice DWT$C_CRFOCUS 
inding: T U 
REASONS C binding: : DwtCRFocus 


The simple text widget has received the input focus. 


Lost Focus , 
VAX binding: DWT$C_CRLOST_FOCUS 
C binding: DwtCRLostFocus 


The simple text widget has lost the input focus. 
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Value Changed 
VAX binding: DWT$C_CRVALUE_CHANGED 
C binding: DwtCRValueChanged 


The user changed the value of the text string in the simple text widget. 


Help Requested 
VAX binding: DWT$C_CRHELP_REQUESTED 
C binding: DwtCRHelpRequested 


The user selected help. 





DESCRIPTION 


geometry 
management 


resizing 


S TEXT CREATE creates a simple text widget. This widget enables the 
application to display a single or multiline field of text for input and 
editing by the user. By default the text window expands or shrinks as the 
user enters or deletes text characters. Note that the text window does not 
shrink below the initial size set at creation time. 


A simple text widget can also be created with the high-level routine 
S TEXT. 


The simple text widget does not support children. 


The simple text widget does not support children. 
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TOGGLE BUTTON CREATE 


Creates a toggle button widget. 








WIDGET CLASS 
HIERARCHY Sis 
\ 
composite 
\ 
common 
\ 
label 
\ 
toggle button 
VAX FORMAT _ widget =DWT$TOGGLE_BUTTON_CREATE 


(parent_widget, name, override_arglist, 
override_argcount) 


argument 

information Argument Usage Data Type Access Mechanism 
widget widget uns longword write value 
parent_widget widget uns longword read reference 
name char string char string read descriptor 
override_arglist arglist uns longword read reference 
override_argcount uns longword uns longword read reference 

attribute The following widget-specific attributes can be set in the override_ 

information arglist: 
Attribute Usage Data Type Access Mechanism 
shape uns byte uns byte read value 
visible_when_off Boolean uns byte read value 
spacing uns longword uns longword read value 
pixmap_on uns longword uns longword read value 
pixmap_off pixmap uns longword read value 
value Boolean uns byte read value 
arm_callback callback uns longword read reference 
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Attribute 


disarm_callback 


value_changed_ 
callback 


indicator 
accelerator_text 


button_accelerator 
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Usage Data Type Access Mechanism 
callback uns longword read reference 
callback uns longword read reference 
Boolean uns byte read value 

comp string uns longword read reference 
char string char string read reference 











MIT C FORMAT widget = DwtToggleButtonCreate 
(parent_widget, name, override_arglist, 
override_argcount) 

argument 

information Widget DwtToggleButtonCreate(parent_widget, name, 

override arglist, override _argcount) 
Widget parent _widget; 
char *name; 
ArgList override _arglist; 
int override _argcount; 
attribute The following widget-specific attributes can be set in the override_ 
information arglist: 
unsigned char shape; 
Boolean visible when_off; 
short spacing; 
Pixmap pixmap_on; 
Pixmap pixmap_off; 
Boolean value; 
DwtCallbackPtr arm_callback; 
DwtCallbackPtr disarm_callback; 
DwtCallbackPtr value _changed_caliback; 
Boolean indicator; 
DwtCompString *accelerator text; 
char *button_ accelerator; 
RETURNS widget 
The identifier of the created widget. 
ARGUMENTS _ parent_widget 


The identifier of the parent widget. 


name 


The name of the created widget. 


override_arglist 


The application override argument list. 
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override_argcount 
The number of arguments in the application override argument list. 





WIDGET- 
SPECIFIC 
ATTRIBUTES 
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shape 
VAX binding: DWT$C_NSHAPE 
Chinding: DwtNshape 


The toggle button indicator shape, which can be either rectangular or oval. 
The shape is used only when the label_type attribute is defined as text. 
The predefined values for this attribute are the following: 


VMS Cc Description 

DWT$C_RECTANGULAR  DwtRectangular A rectangular toggle button indicator 
(default) 

DWT$C_OVAL DwtOval _ An oval toggle button indicator 


(used for radio buttons) 


Programmers cannot replace the indicator with their own pixmap. 


visible_when_off 
VAX binding: DWT$C_NVISIBLE_WHEN_OFF 
C binding: DwtNvisibleWhenOff 


A Boolean attribute that, if true, specifies that the button is visible when 
in the off state. The default is true. 


spacing 
VAX binding: DWT$C_NSPACING 
C binding: DwtNspacing 


The number of pixels between the label and the button if label_type is 
not pixmap. The default is 4 pixels. 


pixmap_on 
VAX binding: DWT$C_NPIXMAP_ON 
C binding: DwtNpixmapOn 


The pixmap to be used as the button label if label_type is pixmap and the 
toggle button is in the on state. The default is null. 


pixmap_off 
VAX binding: DWT$C_NPIXMAP_OFF 
C binding: DwtNpixmapOff 


The pixmap to be used as the button label if label_type is pixmap and the 
toggle button is in the off state. The default is null. 


value 
VAX binding: DWT$C_NVALUE 
C binding: DwtNvalue 


The value of the toggle button, which can be either true or false. The 
default is false. . 
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arm_callback 
VAX binding: DWT$C_NARM_CALLBACK 
C binding: DwtNarmCallback 


The callback routine or routines called when the toggle button is armed. 
The toggle button is armed when the user presses and releases MB1 
while the pointer is inside the toggle button widget. For this routine, the 
callback reason is Arm. The default is null. 


disarm_callback 
VAX binding: DWT$C_NDISARM_CALLBACK 
C binding: DwtNdisarmCallback 


The callback routine or routines called when the toggle button is disarmed. 
The button is disarmed when the user presses MB1 while the pointer is 
inside the toggle button widget, but moves the pointer outside the toggle 
button before releasing MB1. For this routine, the callback reason is 
Disarm. The default is null. 


value_changed_callback 
VAX binding: DWT$C_NVALUE_CHANGED_CALLBACK 
C binding: DwtNvalueChangedCallback 


The callback routine or routines called because the value has changed. For 
this routine, the callback reason is Value Changed. The default is null. 


indicator 
VAX binding: DWT$C_NINDICATOR 
C binding: DwtNindicator 


A Boolean attribute that, if true, specifies that the indicator is present in 
the toggle button. If false, the indicator is not present. The default is true 
if the label is text, and false if the label is pixmap. 


accelerator_text 
VAX binding: DWT$C_NACCELERATOR_TEXT 
C binding: DwtNacceratorText 


The text displayed with the accelerator. The default is null. 


button_accelerator 
VAX binding: DWT$C_NBUTTON_ACCELERATOR 
C binding: DwtNbuttonAccelerator 


The accelerator on a push button widget. This attribute is the same 

as the common argument translations except that only the left 

side of the table is passed as a character string, not compiled. The 
application is responsible for calling the intrinsic routine INSTALL ALL 
ACCELERATORS to install the accelerator where the application needs 
it. See the VMS DECwindows Guide to Application Programming for 
information on translation tables. The default is null. 
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ATTRIBUTE The following common attributes are supported differently by TOGGLE 
EXCEPTIONS BUTTON CREATE: 
¢ The default for width equals the width of the label or pixmap plus 
three times margin_width, plus the width of the indicator. 
e The default for height equals the height of the label or pixmap plus 
two times margin_height. 
¢ The default for border_width is zero. 
CALLBACK 
DATA 31 0 
STRUCTURE 
ZK-0096A-GE 
VAX field Structure name: DWT$TOGGLE_CB_ST 
information 
Name Usage Data Type Access Mechanism 
toggle_reason _ callback reason longword read value 
toggle_event event uns longword read reference 
toggle_value longword longword read value 





MIT C field 
information RenSeot Pence. 
int reason; 
XEvent *event; 
int value; 
} DwtToggleButtonCallbackStruct 
CALLBACK reason . 
FIELD An integer set to the callback reason. See the Callback Reasons section for 
the values applicable to this widget. 
DESCRIPTIONS 
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event 


A pointer to the X event structure describing the event that generated this 
callback. 


value 
The state of the toggle button when the callback occurred. 
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CALLBACK 
REASONS 


Value Changed 
VAX binding: DWT$C_CRVALUE_CHANGED 
C binding: DwtCRValueChanged 


The user activated the toggle button to change the state. 


Arm 
VAX binding: DWT$C_CRARM 
C binding; DwtCRArm 


The user armed the toggle button by pressing MB1 while the pointer was 
inside the toggle button widget. 


Disarm 
VAX binding: DWT$C_CRDISARM 
C binding: DwtCRDisarm 


The user disarmed the toggle button by pressing MB1 while the pointer 
was inside the toggle button widget, and not releasing it until after moving 
the pointer outside the toggle button widget. 


Help Requested 
VAX binding: DWT$C_CRHELP_REQUESTED 
C binding: DwtCRHelpRequested 


The user selected help. 





DESCRIPTION 


geometry 
management 


resizing 


TOGGLE BUTTON CREATE creates a toggle button widget. The toggle 
button widget consists of either a label and indicator button combination 
or simply a pixmap (icon). Toggle buttons imply a bi-state (true/false). 
Note that the callback data structure also includes value. This allows 
the callback procedure to pass the status of the toggle switch back to the 
application. 


If label_type is pixmap, that icon is used for both the on and off states of 
the toggle button. 


A toggle button widget can also be created with the high-level routine 
TOGGLE BUTTON. 


The toggle button widget follows the same rules for geometry management 
as its superclass the label widget, described in the low-level routine 
LABEL CREATE. 


The sizing is affected by spacing, the font, and the label. See the low-level 
routine LABEL CREATE for more information. 


Indicator size is based on the height of the toggle button minus twice the 
margin height. The indicator width is equal to the indicator height. 


The default margin height is 4 pixels. The default margin width is 
5 pixels. 
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Low-Level Widget Routines 
WINDOW CREATE 


WINDOW CREATE 


Creates a window widget. 





WIDGET CLASS 
HIERARCHY a 
\ 
composite 
\ 
common 
\ 
window 





VAX FORMAT _ widget =DWT$WINDOW_CREATE 
(parent_widget, name, override_arglist, 
override_argcount) 


argument 

information Argument Usage Data Type Access Mechanism 
widget widget uns longword write value 
parent_widget widget uns longword read reference 
name char string char string read descriptor 
override_arglist arglist uns longword read reference 
override_argcount uns longword uns longword read reference 

attribute The following widget-specific attribute can be set in the override_arglist: 

information ec 
Attribute Usage Data Type Access Mechanism 
expose_callback callback uns longword read reference 
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Low-Level Widget Routines 
WINDOW CREATE 





MIT C FORMAT widget = DwtWindowCreate 
(parent_widget, name, override_arglist, 
override_argcount) 





argument 
information Widget DwtWindowCreate (parent widget, name, override _arglist, 
override _argcount) 
Widget parent widget; 
char *xname; 
ArgList override _arglist; 
int override _argcount; 
attribute The following widget-specific attribute can be set in the override_arglist: 
information DwtCallbackPtr expose_callback; 
RETURNS widget 


The identifier of the created widget. 





ARGUMENTS _ parent_widget 
The identifier of the parent widget. 


name 


The name of the created widget. 


override_arglist 


The application override argument list. 


override_argcount 
The number of arguments in the application override argument list. 








WIDGET- expose_callback 
SPECIFIC The callback routine or routines called when the window had an expose 
ATTRIBUTES event. The reason for this callback is Expose. The default is null. 
ATTRIBUTE The following common attributes are not supported by WINDOW 
EXCEPTIONS °SEATE: 

¢ font 


¢ help_callback 


Low-Level Widget Routines 
WINDOW CREATE 













CALLBACK 
DATA 31 0 
STRUCTURE 
ZK-0097A-GE 
VAX field Structure name: DWT$WINDOW_CB_ST 
information 
Name Usage Data Type Access Mechanism 
window_reason callback reason longword read value 
window_event event uns longword read reference 
window_w window uns longword read value 
MIT C field 
information EYPedet SERUCE 
int reason; 
XExposeEvent *event; 
Window Ww; 
} DwtWindowCallbackStruct; 
CALLBACK reason 
FIELD An integer set to the callback reason. See the Callback Reasons section for 
the values applicable to this widget. 
DESCRIPTIONS 
event 
A pointer to the X event structure describing the event that generated this 
callback. 
Ww 


The X window identifier where the expose event occurred. 





CALLBACK Expose 
VAX binding: DWT$C_CREXPOSE 
REASONS C binding: e ulhaeecaana 


An expose event occurred. 
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Low-Level Widget Routines 
WINDOW CREATE 





DESCRIPTION WINDOW CREATE creates a window widget. 
This routine creates a window in which applications can display graphics. 


A window widget can also be created with the high-level routine WINDOW. 


geometry | Because a window widget does not support children, it does not accept 
management geometry requests. 
resizing The window widget does not support children. 
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Low-Level Widget Routines 
WORK BOX CREATE 


WORK BOX CREATE 


Creates a work box widget. 





WIDGET CLASS 
HIERARCHY a 
\ 
composite 
\ 
constraint 
\ 
dialog 
\ 
work box 





VAX FORMAT __ widget = DWT$WORK_BOX_CREATE 
(parent_widget, name, override_arglist, 
override_argcount) 


argument 

information Argument Usage Data Type Access Mechanism 
widget widget uns longword write value 
parent_widget widget uns longword read reference 
name char string char string read descriptor 
override_arglist arglist uns longword read reference 
override_argcount uns longword uns longword read reference 


The following widget-specific attributes can be set in the override_ 


arglist: 

Attributes Usage Data Type Access Mechanism 
label comp string uns longword read reference 
cancel_label comp string uns longword read reference 
cancel_callback callback uns longword read reference 


MIT C FORMAT widget = DwtWorkBoxCreate 
(parent_widget, name, override_arglist, 
override_argcount) 
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argument 
information 


Low-Level Widget Routines 
WORK BOX CREATE 


Widget DwtWorkBoxCreate (parent widget, name, override _arglist, 
override _argcount) 
Widget parent widget; 


char *name; 
ArgList override arglist; 
int override argcount; 


Attributes described in the low-level routine CAUTION BOX CREATE 
(with exceptions) and the following widget-specific attributes can be set in 
the override_arglist: 


DwtCompSt ring label; 
DwtCompSt ring cancel label; 
DwtCallbackPtr cancel callback; 





RETURNS 


widget 
The identifier of the created widget. 





ARGUMENTS 


parent_widget 
The identifier of the parent widget. 


name 
The name of the created widget. 


override_arglist 


The application override argument list. 


override_argcount 


The number of arguments in the application override argument list. 





WIDGET- 
SPECIFIC 
ATTRIBUTES 


label 
VAX binding: DWT$C_NLABEL 
C binding: DwtNlabel 


The text for the message line or lines. The default is the widget name. 


cancel_label 
VAX binding: DWT$C_NANCEL_LABEL 
C binding: DwtNcancelLabel 


The label for the Cancel push button. If the label is a null string, the 
button is not displayed. The default is “Cancel”. 


cancel_callback 
VAX binding: DWT$C_NCANCEL_CALLBACK 
C binding: DwtNeancelCallback 


The callback routine or routines called when the Cancel button is 
displayed. The reason for this callback is Cancel. The default is null. 
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Low-Level Widget Routines 
WORK BOX CREATE 











ATTRIBUTE The following attributes of the low-level routine DIALOG BOX POPUP 
EXCEPTIONS CREATE are not supported: 
e cancel_button 
° child_overlap 
¢ default_button 
¢ text_merge_translations 
° units 
¢ direction_r_to_l 
The following attributes of the low-level routine DIALOG BOX CREATE 
are supported differently: 
¢ The default for margin_width is 12. 
e The default for margin_height is 10. 
e The default for resize is Shrink Wrap. 
¢ The default for style is Modal. 
CALLBACK 
DATA 31 0 
STRUCTURE 
ZK-0091A-GE 
VAX field Structure name: DWT$ANY_CB_ST 
information a en ee es 
Name Usage Data Type Access Mechanism 
any_reason callback reason longword read value 
any_event event uns longword read reference 
MIT C field 
information pupSees coves A 
ant reason; 
XEvent *event; 
} DwtAnyCallbackStruct; 
CALLBACK reason . 
FIELD An integer set to the callback reason. See the Callback Reasons section for 
the values applicable to this widget. 
DESCRIPTIONS 
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Low-Level Widget Routines 
WORK BOX CREATE 


event 
A pointer to the X event structure describing the event that generated this 
callback. 





CALLBACK 
REASONS 


Cancel 
VAX binding: DWT$C_NCANCEL 
C binding: DwtNeancel 


The user activated the Cancel push button. 


Help Requested 
VAX binding: DWT$C_CRHELP REQUESTED 
C binding: DwtCRHelpRequested 


The user selected help somewhere in the work box. 





DESCRIPTION 


geometry 
management 


resizing 


WORK BOX CREATE creates a work box widget. The work box widget 
is a dialog box that allows the application to display work-in-progress 
messages to the user. When the application determines that an operation 
will take longer than five seconds, it is recommended that the application 
call this routine to display a work box with a message such as Work in 
Progress /Please Wait. 


The work box can contain a push button labeled Cancel Operation. Do not 
include the push button if the operation cannot be canceled. If the style is 
Modal when the user selects the Cancel push button, the widget is cleared 
from screen but not destroyed. The widget can be displayed again by using 
the intrinsic routine MANAGE CHILD. 


A work box widget can also be created with the high-level routine 
WORK BOX. 


The work box widget follows the same rules for geometry management 
as its superclass the dialog box widget, described in the low-level routine 
DIALOG BOX CREATE. 


The work box widget follows the same rules for resizing as its superclass 
the dialog box widget, described in the low-level routine DIALOG BOX 
CREATE. 
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9.1 


Gadget Creation Routines 


Gadget creation routines allow application programmers to create gadgets 
for use in their applications. Gadgets are simple, windowless widgets. 
These low-level gadget creation routines have corresponding low-level 
widget creation routines. 


For concepts related to gadget routines and information about how to use 
them, see the VMS DECwindows Guide to Application Programming. 


Table 9-1 lists the supported gadget creation routines. 


Table 9-1 Gadget Creation Routines 





Routine Name Description 

LABEL GADGET CREATE Creates a label gadget. 

PUSH BUTTON GADGET CREATE Creates a push button gadget. 
SEPARATOR GADGET CREATE Creates a separator gadget. 


TOGGLE BUTTON GADGET CREATE _ Creates a toggle button gadget. 





Gadget Hierarchy 


Like their low-level widget counterparts, gadgets are arranged in a 
hierarchy, The core widget class shown in Figure 9-1 is actually composed 
of three parts: object, rect object, and window object. All gadgets are 
subclasses of rect object. Figure 9-1 shows the gadget hierarchy. 


Gadget Creation Routines 
9.1 Gadget Hierarchy 


Figure 9-1 Gadget Hierarchy 


j 
Equivalent to 
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Push Button 
Gadget 


Separator 
Gadget 
Toggle Button 
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Gadgets support only those core attributes that belong to rect object, not 
the entire set of core attributes as their low-level widget counterparts. The 
core attributes supported by gadgets are the following: 


° x 

ey 

°¢ width 
¢ height 


¢ border_width 
e sensitive 
¢ ancestor_sensitive 


e destroy_callback 


For information on these attributes, see Section 8.2. 





9.2 Gadget Creation Routines 
. The following pages describe the XUI Toolkit gadget creation routines. 
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Gadget Creation Routines 
LABEL GADGET CREATE 


LABEL GADGET CREATE 


Creates a label gadget. 





WIDGET CLASS 
HIERARCHY ee 
\ 
rectangle 
\ 
label gadget 





VAX FORMAT ~~ _ widget = DWT$LABEL_GADGET_CREATE 
(parent_widget, name, override_arglist, 
override_argcount) 


argument 


information Argument —-*Usage~=——~SCT ata Type =A ~—s Mechanism — 


widget longword longword write value 
parent_widget uns longword uns longword read reference 
name char string char string read descriptor 
override_arglist arglist uns longword read reference 
override_argcount —_ uns longword uns longword read reference 
attribute The following widget-specific attributes can be set in the override_ 
information arglist: 
Attribute Usage Data Type Access Mechanism 
label comp string uns longword read reference 
alignment uns longword uns longword read value 
direction_r_to_| Boolean uns longword read value 
help_callback callback uns longword read reference 





MITC FORMAT widget = DwtLabelGadgetCreate 
(parent_widget, name, override_arglist, 
override_argcount) 
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Gadget Creation Routines 
LABEL GADGET CREATE 


argument 
information 


attribute 
information 


Widget DwtLabelGadgetCreate (parent_widget, name, 
override arglist, 
override _argcount) 

Widget parent _widget; 


char *name; 
ArgList override_arglist; 


are override _argcount; 


The following widget-specific attributes can be set in override_arglist: 


DwtCompString label; 

uns char alignment; 
Boolean direction Fr. to:.1; 
DwtCallbackPtr help callback; 





RETURNS 


widget 
The identifier of the created widget. 





ARGUMENTS 


parent_widget 
The identifier of the parent widget. 


name 
The name of the created widget. 


override_arglist 


The application override argument list. 


override_argcount 
The number of arguments in the application override argument list. 





WIDGET- 
SPECIFIC 
ATTRIBUTES 


label 
VAX binding: DWT$C_NLABEL 
C binding: DwtNlabel 


The label for the label widget. The default is the widget name. 


alignment 
VAX binding: DWT$C_NALIGNMENT 
C binding: DwtNalignment 


The label alignment for the text style. The predefined values for this 
attribute are as follows: 


VAX Cc Description 
DWT$C_ALIGNMENT_CENTER  DwtAlignmentCenter Center alignment (default) 
DWT$C_ALIGNMENT_ DwtAlignmentBeginning Alignment at the 
BEGINNING beginning 
DWT$C_ALIGNMENT_END DwtAlignmentEnd Alignment at the end 


Gadget Creation Routines 
LABEL GADGET CREATE 


direction _r_to | 
VAX binding: DWT$C_NDIRECTION_R_TO_L 
C binding: DwtNdirectionRToL 


The direction in which the text is drawn. If false, text is drawn from left 
to right. If true, text is drawn from right to left. The default is false. 


help_callback 
VAX binding: DWT$C_NHELP_CALLBACK 
C binding: DwtNhelpCallback 


The callback descriptor data structure. This data structure defines the 
application routines to be called back on a help request. The default is no 
callback. 





ATTRIBUTE The following core attributes are supported differently by LABEL 


EXCEPTIONS GADGET CREATE: 
¢ The default for width is the width of the label plus margins. 


¢ The default for height is the height of the label plus margins. 
¢ The default for border_width is 0 pixels. 









CALLBACK | 
DATA 31 0 
STRUCTURE 
ZK-0091 A-GE 
VAX field Structure name: DWT$ANY_CB_ST 
information 
Name Usage Data Type Access Mechanism 
reason callback reason longword read value 
event event — uns longword read value 





MIT C field 
information typedef struct { 


int reason; 
XEvent *event; 
} DwtAnyCallbackStruct; 
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Gadget Creation Routines 
LABEL GADGET CREATE 





CALLBACK reason 


FIELD An integer set to the callback reason. See the Callback Reasons section for 
the values applicable to this widget. 

DESCRIPTIONS 
event 
A pointer to the X event structure describing the event that generated this 
callback. 





CALLBACK Help Requested 
VAX binding: DWT$C_CRHELP_REQUESTED 
REASONS C sae (ee hal Sareea 


The user selected help. 





DESCRIPTION LABEL GADGET CREATE creates a label gadget. 


A label gadget is similar in appearance and semantics to a label widget. 
Like all gadgets, LABEL GADGET CREATE does not have a window 
but uses the window of the closest antecedent widget. Consequently, the 
antecedent widget provides all event dispatching for the gadget. This 
currently restricts gadgets to being descendants of menu or dialog class 
(or subclass) widgets. Drawing information, such as font and color, is also 
controlled by the closest antecedent widget. 


geometry Because a label gadget is not a subclass of composite, children are not 
management supported. 
resizing By default, the label gadget is as large as necessary to display the label. 


Gadget Creation Routines 
PUSH BUTTON GADGET CREATE 


PUSH BUTTON GADGET CREATE 


Creates a push button gadget. 





WIDGET CLASS 
HIERARCHY aaa 
“H 
rectangle 
\ 


label gadget 
\ 


push button gadget 





VAX FORMAT ~ widget = DWT$PUSH_BUTTON_GADGET_CREATE 
(parent_widget, name, override_arglist, 
override_argcount) 


argument 


Information Argument —s- Usage. ~=—~CS ata Type = Access.~— Mechanism 


widget longword longword write value 
parent_widget uns longword uns longword read reference 
name char string char string read descriptor 
override_arglist arglist uns longword read reference 
override_argcount uns longword uns longword read reference 
attribute The following widget-specific attributes can be set in the override_ 
information arglist: 
Attribute Usage Data Type Access Mechanism 
activate_callback callback uns longword read reference 
label comp string uns longword read reference 
accelerator_text comp string uns longword read reference 
button_accelerator char string char string read reference 





MIT C FORMAT widget = DwtPushButtonGadgetCreate 
(parent_widget, name, override_arglist, 
override_argcount) 
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Gadget Creation Routines 
PUSH BUTTON GADGET CREATE 


argument 
information 


attribute 
information 


Widget DwtPushButtonGadgetCreate (parent widget, name, 
override arglist, 
override _argcount) 

Widget parent_widget; 
char *name; 

ArgList override_arglist; 
int override argcount; 


The following widget-specific attributes can be set in the override_ 
arglist: 


DwtCallbackPtr activate callback; 
DwtCompString label; 
DwtCompString accelerator text; 
char *button_accelerator; 





RETURNS 


widget 
The identifier of the created widget. 





ARGUMENTS 


parent_widget 
The identifier of the parent widget. 


name 
The name of the created widget. 


override_arglist 
The application override argument list. 


override_argcount 


The number of arguments in the application override argument list. 





WIDGET- 
SPECIFIC 
ATTRIBUTES 


activate_callback 
VAX binding: DWT$C_NACTIVATE_CALLBACK 
C binding: DwtNactivateCallback 


A widget-specific callback routine called when the push button is activated. 
The button is activated when the user presses and releases MB1 while the 
pointer is inside the gadget. . 


label 
VAX binding: DWT$C_NLABEL 
C binding: DwtNlabel 


The push button label. The default is the widget name. 


accelerator_text 
VAX binding: DWT$C_NACCELERATOR_TEXT 
C binding: DwtNacceleratorText 


Compound string text to be displayed for the accelerator. The default is no 
accelerator. 


Gadget Creation Routines 
PUSH BUTTON GADGET CREATE 


button_accelerator 
VAX binding: DWT$C_NBUTTON_ACCELERATOR 
C binding: DwtNbuttonAccelerator 


Sets an accelerator on a push button widget. Same as the common 
argument translations except that only the left side of the table is to be 
passed as a character string, not compiled. The application is responsible 
for calling the intrinsic routine INSTALL ACCELERATOR to install the 
accelerator where the application needs it. See the VMS DECwindows 
Guide to Application Programming for information on translation tables. 
The default is null. 





ATTRIBUTE The following core attributes are supported differently by PUSH BUTTON 


EXCE PTIONS GADGET CREATE: 
¢ The default for width is the width of the label plus margins. 


¢ The default for height is the height of the label plus margins. 
¢ The default for border_width is 1 pixel. 





CALLBACK 
DATA 31 0 
STRUCTURE 
ZK-0091A-GE 
VAX field Structure name: DWT$ANY_CB_ST 
information 
Name Usage Data Type Access Mechanism 
any_reason callback reason longword read value 
any_event event uns longword read value 
MIT C field 
information Rupees seeuce | 


int reason; 
XEvent *event; 
} DwtAnyCallbackStruct; 





CALLBACK reason 
FIELD An integer set to the callback reason. 


DESCRIPTIONS event 


A pointer to the X event structure describing the event that generated this 
callback. 


Gadget Creation Routines 
PUSH BUTTON GADGET CREATE 





CALLBACK 
REASONS 


Activated 
VAX binding: DWT$C_CRACTIVATED 
C binding: DwtCRActivated 


The user activated the push button. 


Help Requested 
VAX binding: DWT$C_CRHELP_REQUESTED 
C binding: DwtHelpRequested 


The user selected help. 





DESCRIPTION 


geometry 
management 


resizing 
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PUSH BUTTON GADGET CREATE creates a push button gadget. 


The sizing is affected by the font and the label. See the low-level widget 
routine LABEL GADGET CREATE for more information. 


Because a push button gadget is not a subclass of composite, children are 
not supported. 


The push button gadget does nothing on a Resize command by its parents. 


Gadget Creation Routines 
SEPARATOR GADGET CREATE 


SEPARATOR GADGET CREATE 


Creates a separator gadget. 





WIDGET CLASS 
HIERARCHY — nee 
\ 


rectangle 


separator gadget 





VAX FORMAT __ widget = DWT$SEPARATOR_GADGET_CREATE 
(parent_widget, name, override_arglist, 
override_argcount) 


argument 

information Argument Usage Data Type Access Mechanism 
widget longword longword write value 
parent_widget uns longword uns longword read reference 
name char string char string read descriptor 
override_arglist arglist uns longword read reference 
override_argcount — uns longword uns longword read reference 

attribute The following widget-specific attributes can be set in the override_ 

information arglist: 
Attribute Usage Data Type Access Mechanism 
orientation uns longword uns longword read value 





MIT C FORMAT widget = DwtSeparatorGadgetCreate 
(parent_widget, name, override_arglist, 
override_argcount) 
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Gadget Creation Routines 
SEPARATOR GADGET CREATE 











argument 
information Widget DwtSeparatorGadgetCreate (parent widget, name, 
override arglist, 
override _argcount) 
Widget parent_widget; 
char *name; 
ArgList override _arglist; 
int override _argcount; 
attribute The following widget-specific attributes can be set in the override_ 
information arglist: 
int orientation; 
RETURNS widget 
The identifier of the created widget. 
ARGUMENTS _ parent_widget 
The identifier of the parent widget. 
name 
The name of the created widget. 
override_arglist 
The application override argument list. 
override_argcount 
The number of arguments in the application override argument list. 
WIDGET- orientation ‘ 
VAX binding: DWT$C_NORIENTATION 
SPECIFIC C binding: DwtNorientation 
ATTRIBUTES 
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The orientation of the separator gadget. The predefined values for this 
attribute are as follows: 


VAX Cc Description 
DWT$C_ORIENTATION_ DwtOrientationHorizontal Horizontal separator 
HORIZONTAL (default) 
DWT$C_ORIENTATION.__ DwtOrientationVertical Vertical separator 
VERTICAL 


A separator gadget draws a centered single-pixel line between the 
appropriate margins. For example, a horizontal separator draws a 
horizontal line from the left margin to the right margin. It is placed 
vertically in the center of the gadget. 


Gadget Creation Routines 
SEPARATOR GADGET CREATE 





ATTRIBUTE The following core attributes are supported differently by SEPARATOR 


EXCEPTIONS GADGET CREATE: 
¢ The default width is 3 pixels. 


e The default height is 3 pixels. 
¢ The default for border_width is 0 pixels. 





DESCRIPTION SEPARATOR GADGET CREATE creates a separator gadget. 


A separator gadget is similar in appearance and semantics to a separator 
widget. Like all gadgets, SEPARATOR GADGET CREATE does not 

have a window but uses the window of the closest antecedent widget. 
Consequently, the antecedent widget provides all event dispatching for the 
gadget. This currently restricts gadgets to being descendants of menu or 
dialog class (or subclass) widgets. 


geometry Because a separator gadget is not a subclass of composite, children are not 
management supported. 
resizing The separator gadget does nothing on a resize by its parents. 
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Gadget Creation Routines 
TOGGLE BUTTON GADGET CREATE 


TOGGLE BUTTON GADGET CREATE 


Creates a toggle button gadget. 





WIDGET CLASS 
HIERARCHY date 
\ 
rectangle 
\ 
label gadget 


\ 
toggle button gadget 





VAX FORMAT ~~ widget = DWT$TOGGLE_BUTTON_GADGET_CREATE 
(parent_widget, name, override_arglist, 
override_argcount) 


argument 

information Argument Usage Data Type Access Mechanism 
widget longword longword write value 
parent_widget uns longword uns longword read reference 
name char string char string read descriptor 
override_arglist arglist uns longword read reference 
override_argcount — uns longword uns longword read reference 

attribute The following widget-specific attributes can be set in the 

‘information override_arglist: 

Attribute Usage Data Type Access Mechanism 
shape uns longword uns longword read value 
value Boolean uns longword read value 
value_changed_ callback uns longword read reference 
callback 
accelerator_text comp string uns longword read reference 
button_accelerator — char string char string read reference 
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Gadget Creation Routines 
TOGGLE BUTTON GADGET CREATE 











MITC FORMAT widget = DwtToggleButtonGadgetCreate 
(parent_widget, name, override_arglist, 
override _argcount) 

argument 

information Widget DwtToggleButtonGadgetCreate (parent _widget, name, 

override arglist, 
override_argcount) 
Widget parent widget; 
char *Aname; 
ArgList override_arglist; 
int override argcount; 
attribute The following widget-specific attributes can be set in the 
information override_arglist: 
int shape; 
Boolean value; 
DwtCallbackPtr value_changed_callback; 
DwtCompString accelerator text; 
char *button_accelerator; 
RETURNS widget 
The identifier of the created widget. 
ARGUMENTS _ parent_widget 


The identifier of the parent widget. 


name 
The name of the created widget. 


override_arglist 
The application override argument list. 


override_argcount 
The number of arguments in the application override argument list. 





WIDGET- 
SPECIFIC 
ATTRIBUTES 


shape 
VAX binding: DWT$C_NSHAPE 
C binding: DwtNshape 


The toggle button indicator shape. The predefined values for this attribute 
are as follows: 
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Gadget Creation Routines 
TOGGLE BUTTON GADGET CREATE 


VMS Cc Description 

DWT$C_RECTANGULAR ~~ DwtRectangular A rectangular toggle button 
indicator (default) 

DWT$C_OVAL DwtOval An oval toggle button indicator 


(used for radio buttons) 


Programmers cannot replace the indicator with their own pixmap. 


value 
VAX binding: DWT$C_NVALUE 
C binding: DwtNvalue 


The value of the toggle button, which can be either true or false. The 
default is false. 


value_changed_callback 
VAX binding: DWT$C_NVALUE_CHANGED_CALLBACK 
C binding: DwtNvalueChangedCallback 


A widget-specific callback routine that enables the application to request 
a callback because the value has changed. For this routine the callback 
reason is Value Changed. The default is null. 


accelerator_text 
VAX binding: DWT$C_NACCELERATOR_TEXT 
C binding: DwtNacceleratorText 


Text displayed with the accelerator. The default is no accelerator. 


button_accelerator 
VAX binding: DWT$C_NBUTTON_ACCELERATOR 
C binding: DwtNbuttonAccelerator 


Sets an accelerator on a toggle button gadget. This argument is the same 
as the common attribute translations except that only the left side of the 
table is to be passed as a character string, not compiled. The application 
is responsible for calling the intrinsic routine INSTALL ACCELERATOR 
to install the accelerator where the application needs it. See the VMS 
DECwindows Guide to Application Programming for information on 
translation tables. The default is null. 





ATTRIBUTE The following core attributes are supported differently by TOGGLE 
EXCEPTIONS BUTTON GADGET CREATE: 


¢ The default for width is the width of the label plus margins. 
¢ The default for height is the height of the label plus margins. 
¢ The default for border_width is 0 pixels. 
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Gadget Creation Routines 
TOGGLE BUTTON GADGET CREATE 
















CALLBACK 
DATA 31 0 
STRUCTURE 
ZK-0096A-GE 
VAX field 
information Structure name: DWT$TOGGLE_CB_ST 
Name Usage Data Type Access Mechanism 
toggle_reason callback reason longword read value 
toggle_event event uns longword read value 
toggle_value Boolean longword read value 
MIT C field 
information ED ROSS SPRer. 
int reason; 
XEvent *event; 
int value; 
} DwtToggleButtonCallbackStruct; 
CALLBACK reason , 
FIELD An integer set to the callback reason. See the Callback Reasons section for 
the values applicable to this widget. 
DESCRIPTIONS 
event 
A pointer to the X event structure describing the event that generated this 
callback. 
value 
The state of the toggle button when the callback occurred. 
CALLBACK Value Changed 
REASONS VAX binding: DWT$C_CRVALUE_CHANGED 


C binding: DwtCRValueChanged 
The user changed the state of the toggle button. 


Help Requested 
VAX binding: DWT$C_CRHELP_REQUESTED 
C binding: DwtCRHelpRequested 


The user selected help. 
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Gadget Creation Routines 
TOGGLE BUTTON GADGET CREATE 





DESCRIPTION 


resizing 
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TOGGLE BUTTON GADGET CREATE creates a toggle button gadget. 


A toggle button gadget is similar in appearance and semantics to a toggle 
button widget. Like all gadgets, TOGGLE BUTTON GADGET CREATE 
does not have a window but uses the window of the closest antecedent 
widget. Consequently, the antecedent widget provides all even dispatching 
for the gadget. This currently restricts gadgets to being descendants of 
menu or dialog class (or subclass) widgets. 


The sizing is affected by the font and the label. See the low-level widget 
routine TOGGLE BUTTON CREATE for more information. 


The indicator size is based on the height of the toggle button. The 
indicator width is equal to the indicator height. 


A 


A.1 


Summary of Widget Attributes (VAX Binding) 


This appendix contains tables listing all attributes for each widget. The 
attributes are listed according to the widget class hierarchy beginning 
with the superclass widget. Any widget-specific exceptions to the inherited 
defaults are listed in the defaults column. 


Each table contains the following information: 

e Attribute name (same for VAX and C binding) 
e VAX name for the attribute 

e VAX data type 

e Default value 





Attached Dialog Box 


See Table A-1 for a summary of attached dialog box widget attributes. 


Table A-1 Attached Dialog Box Attributes 


Attribute 


Core Widget Attributes 


X 


y 


width 

height 

border_width 

border 
border_pixmap 
background 
background_pixmap 
colormap 

sensitive 
ancestor_sensitive 


accelerators 


VAX Name VAX Data Type Default 

DWT$C_NX longword Determined by the geomeiry 
manager 

DWT$C_NY longword Determined by the geometry 
manager 

DWT$C_NWIDTH uns word 5 pixels 

DWT$C_NHEIGHT uns word 5 pixels 

DWT$C_NBORDER_WIDTH uns word 1 pixel 

DWT$C_NBORDER uns longword Default foreground color 

DWT$C_NBORDER_PIXMAP uns longword Null 

DWT$C_NBACKGROUND uns longword Default background color 

DWT$C_NBACKGROUND_PIXMAP _ uns longword Null 

DWT$C_NCOLORMAP uns longword Default color map 

DWT$C_NSENSITIVE uns byte True 

DWT$C_NANCESTOR_SENSITIVE uns byte The bitwise AND of the 


parent widget’s sensitive 
and ancestor_sensitive 
attributes 


DWT$C_NACCELERATORS uns longword Null 


(continued on next page) 


Summary of Widget Attributes (VAX Binding) 
A.1 Attached Dialog Box 


Table A-1 (Cont.) Attached Dialog Box Attributes 


Attribute 


Core Widget Attributes 


depth 
translations 


mapped_when_ 
managed 


screen 
destroy_callback 


Dialog Box Attributes 


foreground 
highlight 
highlight_pixmap 
user_data 
direction_r_to_| 
font 
grab_key_syms 


grab_merge_ 
translations 


help_callback 
units 

style 
focus_callback 


text_merge_ 
translations 


margin_width 
margin_height 
default_position 
child_overlap 
resize 
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VAX Name 


DWT$C_NDEPTH 
DWT$C_NTRANSLATIONS 


DWT$C_NMAPPED_WHEN_ 
MANAGED 


DWT$C_NSCREEN 
DWT$C_NDESTROY_CALLBACK 


DWT$C_NFOREGROUND 
DWT$C_NHIGHLIGHT 
DWT$C_NHIGHLIGHT_PIXMAP 
DWT$C_NUSER_DATA 
DWT$C_NDIRECTION_R_TO_L 
DWT$C_NFONT 
DWT$C_NGRAB_KEY_SYMS 


DWT$C_NGRAB_MERGE_ 
TRANSLATIONS 


DWT$C_NHELP_CALLBACK 
DWT$C_NUNITS 
DWT$C_NSTYLE 
DWT$C_NFOCUS_CALLBACK 


DWT$C_NTEXT_MERGE_ 
TRANSLATIONS 


DWT$C_NMARGIN_WIDTH 
DWT$C_NMARGIN_HEIGHT 
DWT$C_NDEFAULT_POSITION 
DWT$C_NCHILD_OVERLAP 
DWT$C_NRESIZE 


VAX Data Type 


uns longword 
uns longword 
uns byte 


uns longword 
uns longword 


uns longword 
uns longword 
uns longword 
uns longword 
uns byte 

uns longword 
uns longword 
uns longword 


uns longword 
uns byte 
uns byte 
uns longword 
uns longword 


uns word 
uns word 
uns byte 
uns byte 
uns byte 


Default 


Depth of the parent window 
Null 
True 


The parent screen 
Null 


Default foreground color 
Default foreground color 
Null 

Null 

False 

XUI Toolkit font 

Tab key 

See DIALOG BOX CREATE. | 


Null 
DWT$C_FONT_UNITS 
DWT$C_WORK_AREA 
Null 
Null 


1 pixel 

1 pixel 

False 

True 
DWT$C_RESIZE_GROW_ 
ONLY 


(continued on next page) 
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Summary of Widget Attributes (VAX Binding) 
A.1 Attached Dialog Box 


Table A-1 (Cont.) Attached Dialog Box Attributes 


Attribute 


VAX Name 


Widget-Specific Attributes 


default_horizontal_ 
offset 


default_vertical_offset 


rubber_positioning 
fraction_base 


DWT$C_NDEFAULT_ 
HORIZONTAL_OFFSET 


DWT$C_NDEFAULT_VERTICAL_ 
OFFSET 


DWT$C_NRUBBER_POSITIONING 
DWT$C_NFRACTION_BASE 


VAX Data Type 


longword 
{angword 


uns byte 
longword 


Default 


0 pixels 
0 pixels 


uns byte 
100 





Attached Dialog Box Popup 
See Table A—2 for a summary of attached dialog box pop-up widget 


attributes: 


Table A-2 Attached Dialog Box Pop-Up Attributes 


Core Widget Aitributes 


x 


y 


width 

height 

border_width 

border 
border_pixmap 
background 
background_pixmap 
colormap 

sensitive 
ancestor_sensitive 


accelerators 
depth 


DWT$C_NX 
DWT$C_NY 


DWT$C_NWIDTH 
DWT$C_NHEIGHT 
DWT$C_NBORDER_WIDTH 
DWT$C_NBORDER 
DWT$C_NBORDER_PIXMAP 
DWT$C_NBACKGROUND 
DWT$C_NBACKGROUND_PIXMAP 
DWT$C_NCOLORMAP 
DWT$C_NSENSITIVE 
DWT$C_NANCESTOR_SENSITIVE 


DWT$C_NACCELERATORS 
DWT$C_NDEPTH 


longword 
longword 


uns word 
uns word 
uns word 
uns longword 
uns longword 
uns longword 
uns longword 
uns longword 
uns byte 
uns byte 


uns longword 
uns longword 


Determined by the geometry 
manager 


Determined by the geometry 
manager 


0 pixels 

0 pixels 

1 pixel 

Default foreground color 
Null 

Default background color 
Null 

Default color map 

True 


The bitwise AND of the 
parent widget’s sensitive 
and ancestor_sensitive 
attributes 


Null 
Depth of the parent window 


(continued on next page) 
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Summary of Widget Attributes (VAX Binding) 
A.2 Attached Dialog Box Popup 


Table A-2 (Cont.) Attached Dialog Box Pop-Up Attributes 





Core Widget Attributes 





translations 


mapped_when_ 
managed 


screen 
destroy_callback 


DWT$C_NTRANSLATIONS 


DWT$C_NMAPPED_WHEN_ 
MANAGED 


DWT$C_NSCREEN 


DWT$C_NDESTROY_CALLBACK 


uns longword 
uns byte 


uns longword 
uns longword 


Null 
True 


The parent screen 
Null 





Dialog Box Pop-Up Attributes 





foreground 
highlight 
highlight_pixmap 
user_data 
direction_r_to_| 
font 
grab_key_syms 


grab_merge_ 
translations 


help_callback 


focus_callback 


text_merge_ 
translations 


margin_width 
margin_height 
default_position 
child_overlap 
resize 


no_resize 

title 
map_callback 
unmap_callback 


> 


ae 


DWT$C_NFOREGROUND 
DWT$C_NHIGHLIGHT 
DWT$C_NHIGHLIGHT_PIXMAP 
DWT$C_NUSER_DATA 
DWT$C_NDIRECTION_R_TO_L 
DWT$C_NFONT 
DWT$C_NGRAB_KEY_SYMS 


DWT$C_NGRAB_MERGE_ 
TRANSLATIONS 


DWT$C_NHELP_CALLBACK 
DWT$C_NUNITS 
DWT$C_NSTYLE 
DWT$C_NFOCUS_CALLBACK 


DWT$C_NTEXT_MERGE_ 
TRANSLATIONS 


DWT$C_NMARGIN_WIDTH 
DWT$C_NMARGIN_HEIGHT 
DWT$C_NDEFAULT_POSITION 
DWT$C_NCHILD_OVERLAP 
DWT$C_NRESIZE 


DWT$C_NNO_RESIZE 
DWT$C_NTITLE 
DWT$C_NMAP_CALLBACK 
DWT$C_NUNMAP_CALLBACK 


uns longword 
uns longword 
uns longword 
uns longword 
uns byte 

uns longword 
uns longword 
uns longword 


uns longword 
uns byte 
uns byte 
uns longword 
uns longword 


uns word 
uns word 
uns byte 
uns byte 
uns byte 


uns byte 

uns longword 
uns longword 
uns longword 


Default foreground color 
Default foreground color 

Null 

Null 

False 

XUI Toolkit font 

Tab key 

See DIALOG BOX CREATE. 


Null 
DWT$C_FONT_UNITS 
DWT$C_MODELESS 
Null 

Null 


3 pixels 
3 pixels 
False 
True 


DWT$C_RESIZE_GROW_ 
ONLY 


True 
Widget name 
Null 
Nuil 


(continued on next page) 
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Summary of Widget Attributes (VAX Binding) 
A.2 Attached Dialog Box Popup 


Table A-2 (Cont.) Attached Dialog Box Pop-Up Attributes 


Dialog Box Pop-Up Attributes 


take_focus 


auto_unmanage 
default_button 
cancel_button 


DWT$C_NTAKE_FOCUS 


DWT$C_NAUTO_UNMANAGE 
DWT$C_NDEFAULT_BUTTON 
DWT$C_NCANCEL_BUTTON 


Widget-Specific Attributes 


default_horizontal_ 
offset 


default_vertical_offset 


rubber_positioning 
fraction_base 


DWT$C_NDEFAULT_ 
HORIZONTAL_OFFSET 


DWT$C_NDEFAULT_VERTICAL_ 
OFFSET 


DWT$C_NRUBBER_POSITIONING 
DWT$C_NFRACTION_BASE 


uns byte 


uns byte 
uns longword 
uns longword 


longword 
longword 


uns byte 
longword 


True for modal dialog box; 
false for modeless dialog 
box 


True 
Null 
Null 


0 pixels 
0 pixels 


uns byte 
100 





Caution Box 


See Table A~3 for a summary of caution box widget attributes. 


Table A-3 Caution Box Attributes 


Attribute 


Core Widget Attributes 


xX 


y 


width 

height 

border_width 

border 
border_pixmap 
background 
background_pixmap 
colormap 

sensitive 


VAX Name 


DWT$C_NX 
DWT$C_NY 


DWT$C_NWIDTH 
DWT$C_NHEIGHT 
DWT$C_NBORDER_WIDTH 
DWT$C_NBORDER 
DWT$C_NBORDER_PIXMAP 
DWT$C_NBACKGROUND 
DWT$C_NBACKGROUND_PIXMAP 
DWT$C_NCOLORMAP 
DWT$C_NSENSITIVE 


VAX Data Type 


longword 
longword 


uns word 
uns word 
uns word 
uns longword 
uns longword 
uns longword 
uns longword 
uns longword 
uns byte 


Default 


Determined by the geometry 
manager 


Determined by the geometry 
manager . 


5 pixels 

5 pixels 

1 pixel 

Default foreground color 
Null | 
Default background color 
Null 

Default color map 

True 


(continued on next page) 
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Summary of Widget Attributes (VAX Binding) 


A.3 Caution Box 


Table A-3 (Cont.) Caution Box Attributes 


Attribute 


Core Widget Attributes 


ancestor_sensitive 


accelerators 
depth 
translations 


mapped_when_ 
managed 


screen 
destroy_callback 


VAX Name 


DWT$C_NANCESTOR_SENSITIVE 


DWT$C_NACCELERATORS 
DWT$C_NDEPTH 
DWT$C_NTRANSLATIONS 


DWT$C_NMAPPED_WHEN_ 
MANAGED 


DWT$C_NSCREEN 
DWT$C_NDESTROY_CALLBACK 


Dialog Box Pop-Up Attributes 


foreground 
highlight 
highlight_pixmap 
user_data 
direction_r_to_| 
font 
grab_key_syms 


grab_merge_ 
translations 


help_callback 
units 

title 

style 
map_callback 
unmap_callback 
focus_callback 


text_merge_ 
translations 


margin_width 
margin_height 
default_position 
child_overlap 
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DWT$C_NFOREGROUND 
DWT$C_NHIGHLIGHT 
DWT$C_NHIGHLIGHT_PIXMAP 
DWT$C_NUSER_DATA 
DWT$C_NDIRECTION_R_TO_L 
DWT$C_NFONT 
DWT$C_NGRAB_KEY_SYMS 


DWT$C_NGRAB_MERGE_ 
TRANSLATIONS 


DWT$C_NHELP_CALLBACK 
DWT$C_NUNITS 
DWT$C_NTITLE 
DWT$C_NSTYLE 
DWT$C_NMAP_CALLBACK 
DWT$C_NUNMAP_CALLBACK 
DWT$C_NFOCUS_CALLBACK 


DWT$C_NTEXT_MERGE_ 
TRANSLATIONS 


DWT$C_NMARGIN_WIDTH 
DWT$C_NMARGIN_HEIGHT 
DWT$C_NDEFAULT_POSITION 
DWT$C_NCHILD_OVERLAP 


VAX Data Type 


uns byte 


uns longword 
uns longword 
uns longword 
uns byte 


uns longword 
uns longword 


uns longword 
uns longword 
uns longword 
uns longword 
uns byte 

uns longword 
uns longword 
uns longword 


uns longword 
uns byte 

uns longword 
uns byte 

uns longword 
uns longword 
uns longword 
uns longword 


uns word 
uns word 
uns byte 
uns byte 


Default 


The bitwise AND of the 
parent widget’s sensitive 
and ancestor_sensitive 
attributes 


Null 
Depth of the parent window 
Null 
True 


The parent screen 
Null 


Default foreground color 
Default foreground color 

Null 

Null 

Not supported 

XUI Toolkit font 

Tab key 

See DIALOG BOX CREATE. 


Null 

Not supported 
Widget name 
DWT$C_MODAL 
Null 

Null 

Null 

Not supported 


12 pixels 

10 pixels 
False 

Not supported 
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Summary of Widget Attributes (VAX Binding) 


Table A-3 (Cont.) Caution Box Attributes 


Attribute 


VAX Name 


Dialog Box Pop-Up Attributes 


resize 


take_focus 


no_resize 


auto_unmanage 


default_button 
cancel_button 


DWT$C_NRESIZE 


DWT$C_NTAKE_FOCUS 


DWT$C_NNO_RESIZE 


DWT$C_NAUTO_UNMANAGE 
DWT$C_NDEFAULT_BUTTON 
DWT$C_NCANCEL_ BUTTON 


VAX Data Type 


uns byte 


uns byte 


uns byte 
uns byte 
uns longword 
uns longword 


A.3 Caution Box 


Default 


DWT$C_RESIZE_SHRINK_ 
WRAP 


True for modal dialog box; 
false for modeless dialog 
box 


True 
True 
Not supported 
Not supported 





Widget-Specific Attributes 


label 
yes_label 
no_label 
cancel_label 


default_push_button 


yes_callback 
no_callback 


cancel_callback 


DWT$C_NLABEL 
DWT$C_NYES_LABEL 
DWT$C_NNO_LABEL 


_DWT$C_NCANCEL_LABEL 


DWT$C_NDEFAULT_PUSH_ 
BUTTON 


DWT$C_NYES_CALLBACK 
DWT$C_NNO_CALLBACK 


DWT$C_NCANCEL_CALLBACK 


uns longword 
uns longword 
uns longword 
uns longword 
uns longword 


uns longword 
uns longword 
uns longword 


Widget name 
“Yes” 

“No” 
“Cancel” 

Yes button 


Null 
Null 
Null 








Command Window 


See Table A-4 for a summary of command window widget attributes. 


Table A-4 Command Window Attributes 








Attribute VAX Name VAX Data Type Default 

Core Widget Attributes 

Xx DWT$C_NX longword Determined by the geometry 
manager 

y DWT$C_NY longword Determined by the geometry 
manager 

width DWT$C_NWIDTH uns word Zero 

height DWT$C_NHEIGHT uns word Zero 

border_width DWT$C_NBORDER_WIDTH uns word 1 pixel 


(continued on next page) 
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Summary of Widget Attributes (VAX Binding) 


A.4 Command Window 


Table A—4 (Cont.) Command Window Attributes 
Attribute VAX Name 


Core Widget Attributes 


border DWT$C_NBORDER 

border_pixmap DWT$C_NBORDER_PIXMAP 
background DWT$C_NBACKGROUND 
background_pixmap = DWT$C_NBACKGROUND_PIXMAP 
colormap DWT$C_NCOLORMAP 

sensitive DWT$C_NSENSITIVE 


ancestor_sensitive DWT$C_NANCESTOR_SENSITIVE 


accelerators DWT$C_NACCELERATORS 
depth DWT$C_NDEPTH 
DWT$C_NTRANSLATIONS 


DWT$C_NMAPPED_WHEN_ 
MANAGED 


DWT$C_NSCREEN 
DWT$C_NDESTROY_CALLBACK 


translations 


mapped_when_ 
managed 


screen 
destroy_callback 


Dialog Box Attributes 


DWT$C_NFOREGROUND 
DWT$C_NHIGHLIGHT 
DWT$C_NHIGHLIGHT_PIXMAP 
DWT$C_NUSER_DATA 
direction_r_to_| DWT$C_NDIRECTION_R_TO_L 
font DWT$C_NFONT 
DWT$C_NGRAB_KEY_SYMS 


foreground 
highlight 
highlight_pixmap 
user_data 


grab_key_syms 


grab_merge_ DWT$C_NGRAB_MERGE_ 
translations TRANSLATIONS 
help_callback DWT$C_NH ELP_CALLBACK 
units DWT$C_NUNITS 

style DWT$C_NSTYLE 


DWT$C_NFOCUS_CALLBACK 


DWT$C_NTEXT_MERGE_ 
TRANSLATIONS 


DWT$C_NMARGIN_WIDTH 


focus_callback 


text_merge_ 
translations 


margin_widith 
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VAX Data Type 


uns longword 
uns longword 
uns longword 
uns longword 
uns longword 
uns byte 

uns byte 


uns longword 
uns longword 
uns longword 
uns byte 


uns longword 
uns longword 


uns longword 
uns longword 
uns longword 
uns longword 
uns byte 

uns longword 
uns longword 
uns longword 


uns longword 
uns byte 
uns byte 
uns longword 
uns longword 


uns word 


Default 


Default foreground color 
Null 

Default background color 
Null 

Default color map 

True 


The bitwise AND of the 
parent widget’s sensitive 
and ancestor_sensitive 


attributes 


Null 
Depth of the parent window 
Null 
True 


The parent screen 
Null 


Default foreground color 
Default foreground color 
Null 

Null 

Not supported 

XU] Toolkit font 

Tab key 

See DIALOG BOX CREATE. 


Null 

Not supported 
DWT$C_MODAL 
Null 

Not supported 


12 pixels 
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Summary of Widget Attributes (VAX Binding) 
A.4 Command Window 


Table A-4 (Cont.) Command Window Attributes 
Attribute VAX Name VAX Data Type Default 


Dialog Box Attributes 


margin_height DWT$C_NMARGIN_HEIGHT uns word 10 pixels 
default_position DWT$C_NDEFAULT_POSITION uns byte True 
child_overlap DWT$C_NCHILD_OVERLAP uns byte Not supported 
resize DWT$C_NRESIZE uns byte Not supported 


Widget-Specific Attributes 


value DWT$C_NVALUE char string Null 
prompt DWT$C_NPROMPT uns longword “S” 

lines DWT$C_NLINES uns longword 2 lines 
history DWT$C_NHISTORY char string Null string 
command_entered_ DWT$C_NCOMMAND_ENTERED_ uns longword Null 
callback CALLBACK 

value_changed_ DWT$C_NVALUE_CHANGED__ uns longword Null 
callback CALLBACK 

t_translation DWT$C_NT_TRANSLATION uns longword Nuil 





Dialog Box 


See Table A—-5 for a summary of dialog box widget attributes. 


Table A-5 Dialog Box Attributes 
Attribute VAX Name VAX Data Type Default 


Core Widget Attributes 


x DWT$C_NX longword Determined by the geometry 
manager 

y DWT$C_NY longword Determined by the geometry 
manager 

width DWT$C_NWIDTH uns word 5 pixels 

height DWT$C_NHEIGHT uns word 5 pixels 

border_width DWT$C_NBORDER_WIDTH uns word 1 pixel 

border DWT$C_NBORDER uns longword Default foreground color 

border_pixmap DWT$C_NBORDER_PIXMAP uns longword Null 

background DWT$C_NBACKGROUND uns longword Default background color 

background_pixmap DWT$C_NBACKGROUND_PIXMAP _ uns longword Null 

colormap DWT$C_NCOLORMAP uns longword Default color map 
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A.5 Dialog Box 


Table A-5 (Cont.) Dialog Box Attributes 


Attribute 


Core Widget Attributes 


sensitive 


ancestor_sensitive 


accelerators 
depth 
translations 


mapped_when_ 
managed 


screen 
destroy_callback 


VAX Name 


DWT$C_NSENSITIVE 
DWT$C_NANCESTOR_SENSITIVE 


DWT$C_NACCELERATORS 
DWT$C_NDEPTH 
DWT$C_NTRANSLATIONS 


DWT$C_NMAPPED_WHEN_ 
MANAGED 


DWT$C_NSCREEN 
DWT$C_NDESTROY_CALLBACK 


Widget-Specific Attributes 


foreground 
highlight 
highlight_pixmap 
user_data 
direction_r_to_| 
font 
grab_key_syms 


grab_merge_ 
translations 


help_callback 
units 

style 
focus_callback 


text_merge_ 
translations 


margin_width 
margin_height 
default_position 
child_overlap 
resize 
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DWT$C_NFOREGROUND 
DWT$C_NHIGHLIGHT 
DWT$C_NHIGHLIGHT_PIXMAP 
DWT$C_NUSER_DATA 
DWT$C_NDIRECTION_R_TO_L 
DWT$C_NFONT 
DWT$C_NGRAB_KEY_SYMS 


DWT$C_NGRAB_MERGE_ 
TRANSLATIONS 


DWT$C_NHELP_CALLBACK 
DWT$C_NUNITS 
DWT$C_NSTYLE 
DWT$C_NFOCUS_CALLBACK 


DWT$C_NTEXT_MERGE_ 
TRANSLATIONS 


DWT$C_NMARGIN_WIDTH 
DWT$C_NMARGIN_HEIGHT 
DWT$C_NDEFAULT_POSITION 
DWT$C_NCHILD_OVERLAP 
DWT$C_NRESIZE 


VAX Data Type 


uns byte 
uns byte 


uns longword 
uns longword 
uns longword 
uns byte 


uns longword 
uns longword 


uns longword 
uns longword 
uns longword 
uns longword 
uns byte 

uns longword 
uns longword 
uns longword 


uns longword 
uns byte 
uns byte 
uns longword 
uns longword 


uns word 
uns word 
uns byte 
uns byte 
uns byte 


Default 


True 


The bitwise AND of the 
parent widget’s sensitive 
and ancestor_sensitive 
attributes 


Null 
Depth of the parent window 
Null 
True 


The parent screen 
Null 


Default foreground color 
Default foreground color 

Null 

Null 

Not used 

XUI Toolkit font 

Tab key 

See DIALOG BOX CREATE. 


Null 
DWT$C_FONT_UNITS 
DWT$C_WORKAREA 
Null 

Null 


1 pixel 
1 pixel 
False 
True 


DWT$C_RESIZE_GROW_ 
ONLY 
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A.6 Dialog Box Popup 





Dialog Box Popup 
See Table A-6 for a summary of dialog box pop-up widget attributes. 


Table A-6 Dialog Box Pop-Up Attributes 


Attribute 


Core Widget Attributes 


X 


y 


width 

height 

border_width 

border 
border_pixmap 
background 
background_pixmap 
colormap 

sensitive 
ancestor_sensitive 


accelerators 
depth 
translations 


mapped_when_ 
managed 


screen 
destroy_callback 


VAX Name 


DWT$C_NX 
DWT$C_NY 


DWT$C_NWIDTH 
DWT$C_NHEIGHT 
DWT$C_NBORDER_WIDTH 
DWT$C_NBORDER 
DWT$C_NBORDER_PIXMAP 
DWT$C_NBACKGROUND 
DWT$C_NBACKGROUND_PIXMAP 
DWT$C_NCOLORMAP 
DWT$C_NSENSITIVE 
DWT$C_NANCESTOR_SENSITIVE 


DWT$C_NACCELERATORS 
DWT$C_NDEPTH 
DWT$C_NTRANSLATIONS 


DWT$C_NMAPPED_WHEN_ 
MANAGED 


DWT$C_NSCREEN 
DWT$C_NDESTROY_CALLBACK 


Widget-Specific Attributes 


foreground 
highlight 
highlight_pixmap 
user_data 
direction_r_to_| 
font 
grab_key_syms 


DWT$C_NFOREGROUND 
DWT$C_NHIGHLIGHT 
DWT$C_NHIGHLIGHT_PIXMAP 
DWT$C_NUSER_DATA 
DWT$C_NDIRECTION_R_TO_L 
DWT$C_NFONT 
DWT$C_NGRAB_KEY_SYMS 


VAX Data Type 


longword 
longword 


uns word 
uns word 
uns word 
uns longword 
uns longword 
uns longword 
uns longword 
uns longword 
uns byte 
uns byte 


uns longword 
uns longword 
uns longword 
uns byte 


uns longword 
uns longword 


uns longword 
uns longword 
uns longword 
uns longword 
uns byte 

uns longword 
uns longword 


Default 


Determined by the geometry 
manager 


Determined by the geometry 
manager 


0 pixels 

0 pixels 

1 pixel 

Default foreground color 
Null 

Default background color 
Null 

Default color map 

True 


The bitwise AND of the 
parent widget’s sensitive 
and ancestor_sensitive 
attributes 


Null 
Depth of the parent window 
Null 
True 


The parent screen 
Null 


Default foreground color 
Default foreground color 
Null 

Null 

Not used 

XUI Toolkit font 

Tab key 
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A.6 Dialog Box Popup 


Table A-6 (Cont.) Dialog Box Pop-Up Attributes 
Attribute VAX Name VAX Data Type Default 


Widget-Specific Attributes 








grab_merge_ DWT$C_NGRAB_MERGE_ uns longword See DIALOG BOX CREATE. 

translations TRANSLATIONS 

help_callback DWT$C_NHELP_CALLBACK uns longword Null 

units DWT$C_NUNITS uns byte DWT$C_FONT_UNITS 

style DWT$C_NSTYLE uns byte DWT$C_MODELESS 

focus_callback DWT$C_NFOCUS_CALLBACK uns longword Null 

text_merge_ DWT$C_NTEXT_MERGE__ uns longword Null 

translations TRANSLATIONS 

margin_width DWT$C_NMARGIN_WIDTH uns. word 5 pixels 

margin_height DWT$C_NMARGIN_HEIGHT uns word 5 pixels 

default_position DWT$C_NDEFAULT_POSITION uns byte False 

child_overlap DWT$C_NCHILD_OVERLAP uns byte True 

resize DWT$C_NRESIZE uns byte DWT$C_RESIZE_GROW_ 

ONLY 

no_resize DWT$C_NNO_RESIZE uns byte True 

title DWT$C_NTITLE uns longword Widget name 

map_callback DWT$C_NMAP_CALLBACK . uns longword Null 

unmap_callback DWT$C_NUNMAP_CALLBACK uns longword Null 

take_focus DWT$C_NTAKE_FOCUS uns byte True for modal dialog box; 

false for modeless dialog 

box 

auto_unmanage DWT$C_NAUTO_UNMANAGE ~ uns byte True 

default_button DWT$C_NDEFAULT_BUTTON uns longword Null 

cancel_button DWT$C_NCANCEL_BUTTON uns longword Null 

File Selection 


See Table A—7 for a summary of file selection widget attributes. 


Table A-7 File Selection Attributes 
Attribute VAX Name VAX Data Type Default 


Core Widget Attributes 


X DWT$C_NX longword Centered in the parent 
window 

y DWT$C_NY longword Centered in the parent 
window 


(continued on next page) 
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Table A-7 (Cont.) File Selection Attributes 


A.7 File Selection 





Attribute VAX Name VAX Data Type Default 

Core Widget Attributes 

width DWT$C_NWIDTH uns word Width of the list box, plus the 
width of the push buttons, 
plus three times margin_ 
width 

height DWT$C_NHEIGHT uns word Height of the list box, plus 
the height of the text edit 
field, plus the height of 
the label, plus three times 
margin_height 

border_width DWT$C_NBORDER_WIDTH uns word 1 pixel 


border 
border_pixmap 
background 
background_pixmap 
colormap 

sensitive 
ancestor_sensitive 


accelerators 
depth 
translations 


mapped_when_ 
managed 


screen 
destroy_callback 


DWT$C_NBORDER 
DWT$C_NBORDER_PIXMAP 
DWT$C_NBACKGROUND 
DWT$C_NBACKGROUND_PIXMAP 
DWT$C_NCOLORMAP 
DWT$C_NSENSITIVE 
DWT$C_NANCESTOR_SENSITIVE 


DWT$C_NACCELERATORS 
DWT$C_NDEPTH 
DWT$C_NTRANSLATIONS 


DWT$C_NMAPPED_WHEN_ 
MANAGED 


DWT$C_NSCREEN 
DWT$C_NDESTROY_CALLBACK 


Dialog Box Pop-Up Attributes 


uns longword 
uns longword 
uns longword 
uns longword 
uns longword 
uns byte 

uns byte 


uns longword 
uns longword 
uns longword 
uns byte 


uns longword 
uns longword 


Default foreground color 
Null 

Default background color 
Null 

Default color map 

True 


The bitwise AND of the 
parent widget’s sensitive 
and ancestor_sensitive 
attributes 


Null 
Depth of the parent window 
Null 
True 


The parent screen 
Null 





foreground 
highlight 
highlight_pixmap 
user_data 
direction_r_to_| 
font 
grab_key_syms 


grab_merge_ 
translations 


DWT$C_NFOREGROUND 
DWT$C_NHIGHLIGHT 
DWT$C_NHIGHLIGHT_PIXMAP 
DWT$C_NUSER_DATA 
DWT$C_NDIRECTION_R_TO_L 
DWT$C_NFONT 
DWT$C_NGRAB_KEY_SYMS 


DWT$C_NGRAB_MERGE_ 
TRANSLATIONS 


uns longword 
uns longword 
uns longword 
uns longword 
uns byte 

uns longword 
uns longword 
uns longword 


Default foreground color 
Default foreground color 
Null 

Null 

False 

XUI Toolkit font 

Tab key 

See DIALOG BOX CREATE. 
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A.7 File Selection 


Table A-7 (Cont.) File Selection Attributes 





Attribute VAX Name VAX Data Type Default 

Dialog Box Pop-Up Attributes 

help_callback DWT$C_NHELP_CALLBACK uns longword Null 

units DWT$C_NUNITS uns byte DWT$C_FONT_UNITS 

style DWT$C_NSTYLE uns byte DWT$C_MODELESS 

focus_callback DWT$C_NFOCUS_CALLBACK uns longword Null 

text_merge_ DWT$C_NTEXT_MERGE_ uns longword Null 

translations TRANSLATIONS . 

margin_width DWT$C_NMARGIN_WIDTH uns word 5 pixels 

margin_height DWT$C_NMARGIN_HEIGHT uns word 5 pixels 

default_position DWT$C_NDEFAULT_POSITION uns byte False 

child_overlap DWT$C_NCHILD_OVERLAP uns byte True 

resize DWT$C_NRESIZE uns byte DWT$C_RESIZE_GROW_. 
ONLY 

no_resize DWT$C_NNO_RESIZE uns byte True 

title DWT$C_NTITLE uns longword “Open” 

map_callback DWT$C_NMAP_CALLBACK uns longword Null 

unmap_callback DWT$C_NUNMAP_CALLBACK uns longword Null 


take_focus 


auto_unmanage 
default_button 
cancel_button 


Selection Attributes 


label 

value 
selection_label 
ok_label 
cancel_label 
activate_callback 
cancel_callback 
no_match_callback 
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DWT$C_NTAKE_FOCUS 


DWT$C_NAUTO_UNMANAGE 
DWT$C_NDEFAULT_BUTTON 
DWT$C_NCANCEL_BUTTON 


DWT$C_NLABEL 

DWT$C_NVALUE 
DWT$C_NSELECTION_LABEL 
DWT$C_NOK_LABEL 
DWT$C_NCANCEL_LABEL 
DWT$C_NACTIVATE_CALLBACK 
DWT$C_NCANCEL_CALLBACK 
DWT$C_NNO_MATCH_CALLBACK 


uns byte 


uns byte 
uns longword 
uns longword 


uns longword 
uns longword 
uns longword 
uns longword 
uns longword 
uns longword 
uns longword 
uns longword 


True for modal dialog box; 
false for modeless dialog 
box 


True 
Nuil 
Null 


“Items” 
Null string 
“Files in” 
“OK” 
“Cancel” 
Null 

Null 

Null 


(continued on next page) 
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Table A-7 (Cont.) File Selection Attributes 


A.7 File Selection 





Attribute VAX Name VAX Data Type Default 
Selection Attributes 

visible_item_count DWT$C_NVISIBLE_ITEMS_COUNT — uns longword 8 items 
items DWT$C_NITEMS uns longword Null 
item_count DWT$C_NITEMS_COUNT uns longword Zero 
must_maitch DWT$C_NMUST_MATCH uns byte False 
Widget-Specific Attributes 

filter_label DWT$C_NFILTER_LABEL uns longword “File filter” 
apply_label DWT$C_NAPPLY_LABEL uns longword “Filter” 
dir_mask DWT$C_NDIR_MASK uns longword sari 
dir_spec DWT$C_NDIR_SPEC uns longword Null string 


file_search_proc 
list_updated 


DWT$C_NFILE_SEARCH_PROC 
DWT$C_NLIST_UPDATED 


Proc entry mask 


uns byte 


Default file search procedure 
False 








Help 


See Table A~-8 for a summary of help widget attributes. 


Table A-8 Help Attributes 


Attribute 


Core Widget Attributes 


X 


y 


width 

height 

border_width 

border 
border_pixmap 
background 
background_pixmap 
colormap 

sensitive 


VAX Name 


DWT$C_NX 
DWT$C_NY 


DWT$C_NWIDTH 
DWT$C_NHEIGHT 
DWT$C_NBORDER_WIDTH 
DWT$C_NBORDER 
DWT$C_NBORDER_PIXMAP 
DWT$C_NBACKGROUND 
DWT$C_NBACKGROUND_PIXMAP 
DWT$C_NCOLORMAP 
DWT$C_NSENSITIVE 


VAX Data Type 


longword 
longword 


uns word 
uns word 
uns word 
uns longword 
uns longword 
uns longword 
uns longword 
uns longword 
uns byte 


Default 


Determined by the geometry 
manager 


Determined by the geometry 
manager 


Cannot be set by the caller 
Cannot be set by the caller 
1 pixel 

Default foreground color 
Null 

Default background color 
Null 

Default color map 

True 


(continued on next page) 
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A.8 Help 


Table A-8 (Cont.) Help Attributes 


Attribute 


VAX Name 


VAX Data Type 


Default 





Core Widget Attributes 


ancestor_sensitive 


accelerators 
depth 
translations 


mapped_when_ 


managed 
screen 


destroy_callback 


DWT$C_NANCESTOR_SENSITIVE 


DWT$C_NACCELERATORS 
DWT$C_NDEPTH 
DWT$C_NTRANSLATIONS 


DWT$C_NMAPPED_WHEN_ 
MANAGED 


DWT$C_NSCREEN 
DWT$C_NDESTROY_CALLBACK 


Common Widget Attributes 


foreground 
highlight 


highlight_pixmap 


user_data 


direction_r_to_| 


font 


grab_key_syms 


grab_merge_ 
translations 


help_callback 


DWT$C_NFOREGROUND 
DWT$C_NHIGHLIGHT 
DWT$C_NHIGHLIGHT_PIXMAP 
DWT$C_NUSER_DATA 
DWT$C_NDIRECTION_R_TO_L 
DWT$C_NFONT 
DWT$C_NGRAB_KEY_SYMS 


DWT$C_NGRAB_MERGE_ 
TRANSLATIONS 


DWT$C_NHELP_CALLBACK 


uns byte 


uns longword 
uns longword 
uns longword 
uns byte 


uns longword 
uns longword 


uns longword 
uns longword 
uns longword 
uns longword 
uns byte 

uns longword 
uns longword 
uns longword 


uns longword 


The bitwise AND of the 
parent widget’s sensitive 
and ancestor_sensitive 
attributes 


Null 
Depth of the parent window 
Null 
True 


The parent screen 
Null 


Default foreground color 
Default foreground color 

Null 

Null 

False 

XUI Toolkit font 

Tab key 

See DIALOG BOX CREATE. 


Null 





Widget-Specific Attributes 


about_label 


add_topic_label 
application_name 
badframe_message 


badlib_message 


cols 
copy_label 


default_position 


dismiss_label 


DWT$C_NABOUT_LABEL 
DWT$C_NADD_TOPIC_LABEL 
DWT$C_NAPPLICATION_NAME 


DWT$C_NBADFRAME_MESSAGE 


DWT$C_NBADLIB_MESSAGE 


DWT$C_NCOLS 
DWT$C_NCOPY_LABEL 
DWT$C_NDEFAULT_POSITION 
DWT$C_NDISMISS_LABEL 


uns longword 
uns longword 
uns longword 
uns longword 


uns longword 


uns longword 
uns longword 
uns byte 

uns longword 


“About” 
“Additional topics:” 
Null 


“Couldn't find frame %s in 
%x library\n” 


“Couldn’t open %s library 
\n” 


55 character cells 
“Copy” 

True | 

“Dismiss” 
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Table A-8 (Cont.) Help Attributes 


Attribute 


VAX Name 


Widget-Specific Attributes 


edit_label 
erroropen_message 


exit_label 

file_label 

first_topic 
glossary_label 
glossary_topic 
goback_label 
goover_label 
goto_label 
help_font 
help_label 
helpmessage_title 
helpmessage_title_ 
type 

history_label 
historybox_label 
keyword_label 
keywords_label 
library_ spec 
library_type 
nokeyword_message 


notitie_message 


nulllib_ message 
nulltopic_message 


overview_topic 
rows 
saveas_label 
searchapply_label 


searchkeywordbox_ 
label 


search_label 


DWT$C_NEDIT_LABEL 


DWT$C_NERROROPEN_ 
MESSAGE 


DWT$C_NEXIT_LABEL 
DWT$C_NFILE_LABEL 
DWT$C_NFIRST_TOPIC 
DWT$C_NGLOSSARY_LABEL 
DWT$C_NGLOSSARY_TOPIC 
DWT$C_NGOBACK_LABEL 
DWT$C_NGOOVER_LABEL 
DWT$C_NGOTO_LABEL 
DWT$C_NHELP_FONT 
DWT$C_NHELP_LABEL 
DWT$C_NHELPMESSAGE_TITLE 


DWT$C_NHELPMESSAGE_TITLE_ 
TYPE 


DWT$C_NHISTORY_LABEL 
DWT$C_NHISTORYBOX_LABEL 
DWT$C_NKEYWORD_LABEL 
DWT$C_NKEYWORDS_LABEL 
DWT$C_NLIBRARY_SPEC 
DWT$C_NLIBRARY_TYPE 


DWT$C_NNOKEYWORD__ 
MESSAGE 


DWT$C_NNOTITLE_MESSAGE 


DWT$C_NNULLLIB_MESSAGE 
DWT$C_NNULLTOPIC_MESSAGE 


DWT$C_NOVERVIEW_TOPIC 
DWT$C_NROWS 
DWT$C_NSAVEAS_LABEL 
DWT$C_NSEARCHAPPLY_LABEL 


DWT$C_ 
NSEARCHKEYWORDBOX_LABEL 


DWT$C_NSEARCH_LABEL 


VAX Data Type 


uns longword 
uns longword 


uns longword 
uns longword 
uns longword 
uns longword 
uns longword 
uns longword 
uns longword 
uns longword 
uns longword 
uns longword 
uns longword 
unsigned char 


uns longword 
uns longword 
uns longword 
uns longword 
uns longword 
uns longword 
uns longword 


uns longword 


uns longword 
uns longword 


uns longword 
uns longword 
uns longword 
uns longword 
uns longword 


uns longword 


A.8 Help 


Default 


“Edit” 
“Error opening file %s\n” 


“Exit” 

“File” 

Null 

“Glossary” 

Null 

“Go Back” 

“Go to Overview” 
“Go To” 

The default help font 
“Help” 

“Message” 
DWT$C_CSTRNG 


“History...” 

“Help Topic History” 
“Keyword...” 

“Keyword: ” 

Null 
DWT$C_TEXT_LIBRARY 


“Couldn't find keyword 
%s\n” 


“No title to match 
string%s\n” 


“No library specified\n” 


“No first topic and overview 
topic specified\n” 


Null 
20 lines 
“Save As...” 


“Apply” 
“Search Topic Keywords” 


“Search” 


(continued on next page) 
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A.8 Help 


Table A-8 (Cont.) Help Attributes 


Attribute VAX Name 


Widget-Specific Attributes 


searchtitlebox_label DWT$C_NSEARCHTITLEBOX_ 


LABEL 
DWT$C_NSELECTALL_LABEL 
DWT$C_NTITLE_LABEL 
DWT$C_NTITLES_LABEL 
DWT$C_NTOPICTITLES_LABEL 
DWT$C_NVIEW_LABEL 
DWT$C_NVISITGLOS_LABEL 
DWT$C_NVISIT_LABEL 
DWT$C_NUNMAP_CALLBACK 


selectall_label 
title_label 
titles_label 
topictitles_label 
view_label 
visitglos_label 
visit_label 
unmap_callback 


VAX Data Type 


uns longword 


uns longword 
uns longword 
uns longword 
uns longword 
uns longword 
uns longword 
uns longword 
uns longword 


Default 


“Search Topic Titles” 


“Select All” 
“Title...” 

“Title:” 

“Topic Titles:” 
“View” 

“Visit Glossary” 
“Visit” 

Null 





Label 


See Table A-9 for a summary of label widget attributes. 


Table A-9 Label Attributes 


Attribute VAX Name 

Core Widget Attributes 

Xx DWT$C_NX 

y DWT$C_NY 

width DWT$C_NWIDTH 
height DWT$C_NHEIGHT 


border_width 
border 


DWT$C_NBORDER_WIDTH 
DWT$C_NBORDER 
DWT$C_NBORDER_PIXMAP 
DWT$C_NBACKGROUND 
~ DWT$C_NBACKGROUND_PIXMAP 
DWT$C_NCOLORMAP 
DWT$C_NSENSITIVE 


border_pixmap 
background 
background_pixmap 
colormap 

sensitive 
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VAX Data Type 


longword 
longword 


uns word 


uns word 


uns word 

uns longword 
uns longword 
uns longword 
uns longword 
uns longword 
uns byte 


Default 


Determined by the geometry 
manager 


Determined by the geometry 
manager 


Width of the label or pixmap, 
plus two times margin__ 
width 


Height of the label or 
pixmap, plus two times 
margin_height 


0 pixels 

Default foreground color 
Null 

Default background color 
Null 

Default color map 

True 
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Table A-9 (Cont.) Label Attributes 
Attribute VAX Name 


Core Widget Attributes 


ancestor_sensitive DWT$C_NANCESTOR_SENSITIVE 


accelerators DWT$C_NACCELERATORS 
depth DWT$C_NDEPTH 
DWT$C_NTRANSLATIONS 


DWT$C_NMAPPED_WHEN_ 
MANAGED 


DWT$C_NSCREEN 
DWT$C_NDESTROY_CALLBACK 


translations 


mapped_when_ 
managed 


screen 
destroy_callback 


Common Widget Attributes 


DWT$C_NFOREGROUND 
DWT$C_NHIGHLIGHT 
DWT$C_NHIGHLIGHT_PIXMAP 
DWT$C_NUSER_DATA 
direction_r_to_l DWT$C_NDIRECTION_R_TO_L 
font DWT$C_NFONT 
DWT$C_NGRAB_KEY_SYMS 


DWT$C_NGRAB_MERGE_ 
TRANSLATIONS 


DWT$C_NHELP_CALLBACK 


foreground 
highlight 
highlight_pixmap 
user_data 


grab_key_syms 


grab_merge_ 
translations 


help_callback 


Widget-Specific Attributes 


label_type DWT$C_NLABEL TYPE 
label DWT$C_NLABEL 


margin_width DWT$C_NMARGIN_WIDTH 


margin_height DWT$C_NMARGIN_HEIGHT 
alignment DWT$C_NALIGNMENT 


pixmap DWT$C_NPIXMAP 


VAX Data Type 


uns byte 


uns longword 
uns longword 
uns longword 
uns byte 


uns longword 
uns longword 


uns longword 
uns longword 
uns longword 
uns longword 
uns byte 

uns longword 
uns longword 
uns longword 


uns longword 


uns byte 
uns longword 
uns word 


uns word 
uns byte 


uns longword 


A.9 Label 


Default 


The bitwise AND of the 
parent widget’s sensitive 
and ancestor_sensitive 
attributes 


Null 
Depth of the parent window 
Null 
True 


The parent screen 
Null 


Default foreground color 
Default foreground color 
Null 

Null 

False 

XUI Toolkit font 

Tab key 

See DIALOG BOX CREATE. 


Null 


DWT$C_CSTRNG 
Widget name 


2 pixels for text; 0 pixels for 
pixmap 


2 pixels for text; 0 pixels for 
pixmap 


DWT$C_ALIGNMENT_ 
CENTER 


Null 


(continued on next page) 
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A.9 Label 


Table A-9 (Cont.) Label Attributes 


Attribute VAX Name VAX Data Type Default 
Widget-Specific Attributes 

margin_left DWT$C_NMARGIN_LEFT uns word 0 pixels 

margin_right DWT$C_NMARGIN_RIGHT uns word 0 pixels 

margin_top DWT$C_NMARGIN_TOP uns word 0 pixels 

margin_bottom DWT$C_NMARGIN_BOTTOM uns word O pixels 
conform_to_text DWT$C_NCONFORM_TO_TEXT uns byte True if width and height 


are zero; false if width and 
height are not zero 





List Box 
See Table A~10 for a summary of list box widget attributes. 


Table A-10 List Box Attributes 
Attribute VAX Name VAX Data Type Default 





Core Widget Attributes 


x DWT$C_NX longword Determined by the geometry 
manager 

y DWT$C_NY longword Determined by the geometry 
manager 

width DWT$C_NWIDTH Dimension As large as necessary to 


hold the longest item without 
exceeding the size of its 
parent 


height DWT$C_NHEIGHT uns word As large as necessary to 
hold the number of items 
specified by visible_item_ 
count without exceeding the 
size of its parent 


border_width DWT$C_NBORDER_WIDTH uns word 1 pixel 

border DWT$C_NBORDER uns longword Default foreground color 
border_pixmap DWT$C_NBORDER_PIXMAP uns longword Null 

background DWT$C_NBACKGROUND uns longword Default background color 
background_pixmap DWT$C_NBACKGROUND_PIXMAP _ uns longword Null 

colormap DWT$C_NCOLORMAP uns longword Default color map 
sensitive DWT$C_NSENSITIVE uns byte True 





(continued on next page) 
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Table A-10 (Cont.) List Box Attributes 


Attribute 


Core Widget Attributes 


ancestor_sensitive 


accelerators 
depth 
translations 


mapped_when_ 


managed 
screen 


destroy_callback 


VAX Name 


DWT$C_NANCESTOR_SENSITIVE 


DWT$C_NACCELERATORS 
DWT$C_NDEPTH 
DWT$C_NTRANSLATIONS 


DWT$C_NMAPPED_WHEN_ 
MANAGED 


DWT$C_NSCREEN 
DWT$C_NDESTROY_CALLBACK 


Common Widget Attributes 


foreground 
highlight 


highlight_pixmap 


user_data 


direction_r_to_| 


font 


grab_key_syms 


grab_merge_ 
translations 


help_callback 


DWT$C_NFOREGROUND 
DWT$C_NHIGHLIGHT 
DWT$C_NHIGHLIGHT_PIXMAP 
DWT$C_NUSER_DATA 
DWT$C_NDIRECTION_R_TO_L 
DWT$C_NFONT 
DWT$C_NGRAB_KEY_SYMS 


DWT$C_NGRAB_MERGE_ 
TRANSLATIONS 


DWT$C_NHELP_CALLBACK 


Scroll Window Attributes 


h_scroll 
v_scroll 


work_window 


shown_value_ 
automatic_horiz 


shown_value_ 
automatic_vert 


DWT$C_NHORIZONTAL_SCROLL_ 
BAR 


DWT$C_NVERTICAL_SCROLL_ 
BAR 


DWT$C_NWORK_WINDOW 


DWT$C_NSHOWN_VALUE_ 
AUTOMATIC_HORIZ 


DWT$C_NSHOWN_VALUE_ 
AUTOMATIC_VERT 


VAX Data Type 


uns byte 


uns longword 
uns longword 
uns longword 
uns byte 


uns longword 
uns longword 


uns longword 


uns longword 


uns longword 
uns longword 
uns byte 

uns longword 
uns longword 
uns longword 


uns longword 


uns longword 
uns longword 


uns longword 
uns byte 


uns byte 


A.10 List Box 


Default 


The bitwise AND of the 
parent widget’s sensitive 
and ancestor_sensitive 
attributes 


Null 
Depth of the parent window 
Null 
True 


The parent screen 
Null 


Default foreground color 
Default foreground color 

Null 

Null 

False 

Not supported 

Tab key 

See DIALOG BOX CREATE. 


Not supported 


Null 
Null 


Null 
True 


False 
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A.10 List Box 


Table A-10 (Cont.) List Box Attributes 


Attribute 


VAX Name 


Widget-Specific Attributes 


margin_width 
margin_height 
spacing 

items 

item_count 
selected_items 
selected_items_count 


visible_item_count 


single_selection 
resize 
horiz 


DWT$C_NMARGIN_WIDTH 
DWT$C_NMARGIN_HEIGHT 
DWT$C_NSPACING 
DWT$C_NITEMS 
DWT$C_NITEMS_COUNT 
DWT$C_NSELECTED_ITEMS 


DWT$C_NSELECTED_ITEMS_ 
COUNT 


DWT$C_NVISIBLE_ITEMS_COUNT 


DWT$C_NSINGLE_SELECTION 
DWT$C_NRESIZE 
DWT$C_NHORIZONTAL 


VAX Data Type 


uns word 
uns word 
uns word 
comp string 
uns longword 
uns longword 
uns longword 


uns longword 


uns byte 
uns byte 
uns byte 


Default 


10 pixels 
4 pixels 
1 pixel 
Null 
Zero 
Null 
Zero 


As many items as can fit in 
the core attribute height 


True 
DWT$C_GROW_ONLY 
False 





single_callback DWT$C_NSINGLE_CALLBACK uns longword Null 
single_confirm_ DWT$C_NSINGLE_CONFIRM__ uns longword Null 
callback CALLBACK 

extend_callback DWT$C_NEXTEND_CALLBACK uns longword Null 
extend_confirm_ DWT$C_NEXTEND_CONFIRM_ uns longword Null 
callback CALLBACK 

Main Window 


See Table A-11 for a summary of main window widget attributes. 


Table A—11 Main Window Attributes 


Attribute 


Core Widget Attributes 


X 


> 


width 

height 
border_width 
border 


border_pixmap 
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VAX Name 


DWT$C_NX 
DWT$C_NY 


DWT$C_NWIDTH 
DWT$C_NHEIGHT 
DWT$C_NBORDER_WIDTH 
DWT$C_NBORDER 
DWT$C_NBORDER_PIXMAP 


VAX Data Type 


longword 
longword 


uns word 
uns word 
uns word 
uns longword 
uns longword 


Default 


Determined by the geometry 
manager 


Determined by the geometry 
manager 


5 pixels 

5 pixels 

1 pixel 

Default foreground color 
Null 
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Table A-11 (Cont.) Main Window Attributes 


Attribute VAX Name 


Core Widget Attributes 


background DWT$C_NBACKGROUND 
DWT$C_NBACKGROUND_PIXMAP 
DWT$C_NCOLORMAP 
DWT$C_NSENSITIVE 


DWT$C_NANCESTOR_SENSITIVE 


background_pixmap 
colormap 

sensitive 
ancestor_sensitive 


accelerators — DWT$C_NACCELERATORS 
depth DWT$C_NDEPTH 
DWT$C_NTRANSLATIONS 


DWT$C_NMAPPED_WHEN_ 
MANAGED 


DWT$C_NSCREEN 
DWT$C_NDESTROY_CALLBACK 


translations 


mapped_when_ 
managed 


screen 
destroy_callback 


Common Widget Attributes 


DWT$C_NFOREGROUND 
DWT$C_NHIGHLIGHT 
DWT$C_NHIGHLIGHT_PIXMAP 
DWT$C_NUSER_DATA 
direction_r_to_]| DWT$C_NDIRECTION_R_TO_L 
font DWT$C_NFONT 
DWT$C_NGRAB_KEY_SYMS 


foreground 
highlight 
highlight_pixmap 
user_data 


grab_key_syms 


grab_merge_ DWT$C_NGRAB_MERGE_ 
translations TRANSLATIONS 
help_callback DWT$C_NHELP_CALLBACK 
Widget-Specific Attributes 


DWT$C_NCOMMAND_WINDOW 
DWT$C_NWORK_WINDOW 
DWT$C_NMENU_BAR 


command_window 
work_window 
menu_bar 


VAX Data Type 


uns longword 
uns longword 
uns longword 
uns byte 
uns byte 


uns longword 
uns longword 
uns longword 
uns byte 


uns longword 
uns longword 


uns longword 
uns longword 
uns longword 
uns longword 
uns byte 

uns longword 
uns longword 
uns longword 


uns longword 


uns longword 
uns longword 
uns longword 


A.11 Main Window 


Default 


Default background color 
Null 

Default color map 

True 


The bitwise AND of the 
parent widget’s sensitive 
and ancestor_sensitive 
attributes 


Null 
Depth of the parent window 
Null 
True 


The parent screen 
Null 


Default foreground color 

Not supported 

Not supported 

Null 

False 

Not supported 

Tab key 

See DIALOG BOX CREATE. 


Null 


Null 
Null 
Null 


{continued on next page) 
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A.11 Main Window 


Table A-11 (Cont.) Main Window Attributes 





Attribute VAX Name VAX Data Type Default 

Widget-Specific Attributes 

horizontal_scroll_bar DWT$C_NHORIZONTAL_SCROLL_ uns longword Null 
BAR 

vertical_scroll_bar DWT$C_NVERTICAL_SCROLL_ uns longword Null 
BAR 

accept_focus DWT$C_NACCEPT_FOCUS uns byte False 

focus_callback DWT$C_NFOCUS_CALLBACK uns longword Null 





Menu Bar 


See Table A-12 for a summary of menu bar widget attributes. 


Table A-12 Menu Bar Attributes 


Attribute VAX Name VAX Data Type Default 

Core Widget Attributes 

x DWT$C_NX longword Determined by the geometry 
manager 

y DWT$C_NY longword Determined by the geometry 
manager 

width DWT$C_NWIDTH uns word 16 pixels 

height DWT$C_NHEIGHT uns word Number of lines needed to 

display all entries 
border_width DWT$C_NBORDER_WIDTH uns word 1 pixel 


border 
border_pixmap 
background 
background_pixmap 
colormap 

sensitive 
ancestor_sensitive 


accelerators 


DWT$C_NBORDER 
DWT$C_NBORDER_P!IXMAP 
DWT$C_NBACKGROUND 
DWT$C_NBACKGROUND_PIXMAP 
DWT$C_NCOLORMAP 
DWT$C_NSENSITIVE 
DWT$C_NANCESTOR_SENSITIVE 


DWT$C_NACCELERATORS 


uns longword 
uns longword 
uns longword 
uns longword 
uns longword 
uns byte 

uns byte 


uns longword 


Default foreground color 
Null 

Default background color 
Null 

Default color map 

True 


The bitwise AND of the 
parent widget’s sensitive 
and ancestor_sensitive 
attributes 


Null 
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Table A—12 (Cont.) Menu Bar Attributes 


Attribute 


Core Widget Attributes 


depth 
translations 


mapped_when_ 


managed 
screen 


destroy_callback 


VAX Name 


DWT$C_NDEPTH 
DWT$C_NTRANSLATIONS 


DWT$C_NMAPPED_WHEN_ 
MANAGED 


DWT$C_NSCREEN 


DWT$C_NDESTROY_CALLBACK 


VAX Data Type 


uns longword 
uns longword 
uns byte 


uns longword 
uns longword 


A.12 Menu Bar 


Default 


Depth of the parent window 
Null 
True 


The parent screen 
Null 





Common Widget Attributes 


foreground 
highlight 


highlight_pixmap 


user_data 


direction_r_to_| 


font 


grab_key_syms 


grab_merge_ 
translations 


help_ callback 


Menu Attributes 


orientation 


spacing 
adjust_margin 
margin_width 
margin_height 
entry_border 


menu_alignment 
entry_alignment 


menu_packing 


~ menu_num_columns 


menu_radio 


DWT$C_NFOREGROUND 
DWT$C_NHIGHLIGHT 
DWT$C_NHIGHLIGHT_PIXMAP 
DWT$C_NUSER_DATA 
DWT$C_NDIRECTION_R_TO_L 
DWT$C_NFONT 


DWT$C_NGRAB_KEY_SYMS 


DWT$C_NGRAB_MERGE_ 
TRANSLATIONS 


DWT$C_NHELP_CALLBACK 


DWT$C_NORIENTATION 


DWT$C_NSPACING 
DWT$C_NADJUST_MARGIN 
DWT$C_NMARGIN_WIDTH 
DWT$C_NMARGIN_HEIGHT 
DWT$C_NENTRY_BORDER 
DWT$C_NMENU_ALIGNMENT 
DWT$C_NENTRY_ALIGNMENT 


DWT$C_NMENU_PACKING 


DWT$C_NMENU_NUM_COLUMNS 


DWT$C_NMENU_RADIO 


uns longword 
uns longword 
uns longword 
uns longword 
uns byte 

uns longword 


uns longword 
uns longword 


uns longword 


uns byte 


uns word 
uns byte 
uns word 
uns word 
uns word 
uns byte 
uns byte 


uns byte 


uns longword 
uns byte 


Default foreground color 
Default foreground color 
Null 

Null 

False 


The default XUI Toolkit font; 
used only by gadget children 


Tab key 
See DIALOG BOX CREATE. 


Null 


DWT$C_ORIENTATION_ 
VERTICAL 


0 pixels 
True 
3 pixels 
0 pixels 
0 pixels 
True 


DWT$C_ALIGNMENT_ 
BEGINNING 


DWT$C_MENU_PACKING_ 
TIGHT 


1 row or column 


False except for radio boxes 
which default to true 
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A.12 Menu Bar 


Table A-—12 (Cont.) Menu Bar Attributes 
Attribute VAX Name 


Menu Attributes 


radio_always_one DWT$C_NRADIO_ALWAYS_ONE 


DWT$C_NMENU_/S_ 
HOMOGENEOUS 


DWT$C_NMENU_ENTRY_CLASS 


menu_is_ 
homogeneous 


menu_entry_class 


menu_history DWT$C_NMENU_HISTORY 
DWT$C_NENTRY_CALLBACK 
DWT$C_NMAP_CALLBACK 
DWT$C_NUNMAP_CALLBACK 


DWT$C_NMENU_HELP_WIDGET 


entry_callback 
map_callback 
unmap_cailback 
menu_help_widget 


VAX Data Type 


uns byte 
uns byte 


identifier 


uns longword 
uns longword 
uns longword 
uns longword 
uns longword 


Default 


True 


False except for radio boxes, 
which default to true 


Null except for radio 
boxes, which default to 
togglebutionwidgetclass 


Zero 
Null 
Null 
Null 
Null 





Menu Attributes 


See Table A-13 for a summary of menu widget attributes. 


Table A-13 Menu Attributes 


Attribute VAX Name 

Core Widget Attributes 

x DWT$C_NX 

y DWT$C_NY 
width DWT$C_NWIDTH 


height DWT$C_NHEIGHT 


border_width 
border 
border_pixmap 


A-26 


DWT$C_NBORDER_WIDTH 
DWT$C_NBORDER 
DWT$C_NBORDER_PIXMAP 


VAX Data Type 


longword 
longword 


uns word 


uns word 


uns word 
uns longword 
uns longword 


Default 


Determined by the geometry 
manager 


Determined by the geometry 
manager 


if orientation is vertical, 
width is the maximum 
entry width or 16 pixels. If 
orientation is horizontal, 
width is the sum of width 
and spacing. 


If orientation is vertical, 
height is the sum of height 
and spacing or 16 pixels. 

If orientation is horizontal, 
height is the maximum entry 
height or 16 pixels 

1 pixel 

Default foreground color 

Null 
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Table A-13 (Cont.) Menu Attributes 
Attribute VAX Name 


Core Widget Attributes 


DWT$C_NBACKGROUND 
DWT$C_NBACKGROUND_PIXMAP 
DWT$C_NCOLORMAP 
DWT$C_NSENSITIVE 
DWT$C_NANCESTOR_SENSITIVE 


background 
background_pixmap 
colormap 

sensitive 
ancestor_sensitive 


accelerators DWT$C_NACCELERATORS 
depth DWT$C_NDEPTH 
DWT$C_NTRANSLATIONS 


DWT$C_NMAPPED_WHEN_ 
MANAGED 


DWT$C_NSCREEN 
DWT$C_NDESTROY_CALLBACK 


translations 


mapped_when_ 
managed 


screen 
destroy_callback 


Common Widget Attributes 


DWT$C_NFOREGROUND 
DWT$C_NHIGHLIGHT 
DWT$C_NHIGHLIGHT_PIXMAP 
DWT$C_NUSER_DATA 
direction_r_to_| DWT$C_NDIRECTION_R_TO_L 
font DWT$C_NFONT 
DWT$C_NGRAB_KEY_SYMS 


foreground 
highlight 
highlight_pixmap 
user_data 


grab_key_syms 


grab_merge_ DWT$C_NGRAB_MERGE_ 
translations TRANSLATIONS 
help_callback DWT$C_NHELP_CALLBACK 


Widget-Specific Attributes 


orientation 


spacing 
adjust_margin 
margin_width 
margin_height 
entry_border 


DWT$C_NORIENTATION 


DWT$C_NSPACING 
DWT$C_NADJUST_MARGIN 
DWT$C_NMARGIN_WIDTH 
DWT$C_NMARGIN_HEIGHT 
DWT$C_NENTRY_BORDER 


VAX Data Type 


uns longword 
uns longword 
uns longword 
uns byte 
uns byte 


uns longword 
uns longword 
uns longword 
uns byte 


uns longword 
uns longword 


uns longword 
uns longword 
uns longword 
uns longword 
uns byte 

uns longword 
uns longword 
uns longword 


uns longword 


uns byte 


uns word 
uns byte 
uns word 
uns word 
uns word 


A.13 Menu Attributes 


Default 


Default background color 
Null 

Default color map 

True 


The bitwise AND of the 
parent widget’s sensitive 
and ancestor_sensitive 
attributes 


Null 
Depth of the parent window 
Null 
True 


The parent screen 
Null 


Default foreground color 
Default foreground color 

Null 

Null 

False 

XUI Toolkit font 

Tab key 

See DIALOG BOX CREATE. 


Null 


DWT$C_ORIENTATION_ 
VERTICAL 


0 pixels 
True 

3 pixels 
3 pixels 
0 pixels 


(continued on next page) 


A927 


ow 


A.14 


Summary of Widget Attributes (VAX Binding) 
A.13 Menu Attributes 


Table A-13 (Cont.) Menu Attributes 


Attribute 


VAX Name 


Widget-Specific Attributes 


menu_alignment 


_entry_alignment 


menu_packing 


menu_num_columns 
menu_radio 


radio_always_one 


menu_is_ 
homogeneous 


menu_entry_class 


menu_history 


DWT$C_NMENU_ALIGNMENT 
DWT$C_NENTRY_ALIGNMENT 


DWT$C_NMENU_PACKING 


DWT$C_NMENU_NUM_COLUMNS 
DWT$C_NMENU_RADIO 


DWT$C_NRADIO_ALWAYS_ONE 


DWT$C_NMENU_IS_ 
HOMOGENEOUS 


DWT$C_NMENU_ENTRY_CLASS 


DWT$C_NMENU_HISTORY 


VAX Data Type 


uns byte 
uns byte 


uns byte 


uns longword 
uns byte 


uns byte 
uns byte 


identifier 


uns longword 


Default 


True 


DWT$C_ALIGNMENT_ 
BEGINNING 


DWT$C_MENU_PACKING_ 
TIGHT for all menu types 
except for radio boxes. 
Radio boxes default to 
DWT$C_MENU_PACKING_ 
COLUMN. 


1 column 


False except for radio boxes, 
which default to true 


True 


False except for radio boxes, 
which default to true 

Null except for radio 

boxes, which default to 
togglebuttonwidgetclass 


Null 





entry_ callback DWT$C_NENTRY_CALLBACK uns longword Null 
map_callback DWT$C_NMAP_CALLBACK uns longword Null 
unmap_callback DWT$C_NUNMAP_CALLBACK uns longword Null 
help_ widget DWT$C_NHELP_WIDGET uns longword Null 
Menu Popup 


See Table A-14 for a summary of menu pop-up widget attributes. 


Table A-14_ Menu Pop-Up Attributes 








Attribute VAX Name VAX Data Type Default 

Core Widget Attributes 

x DWT$C_NX longword Determined by the geometry 
manager 

y DWT$C_NY longword Determined by the geometry 
manager 

width DWT$C_NWIDTH uns word As large as necessary to 


hold all child widgets 
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Table A—14 (Cont.) Menu Pop-Up Attributes 


Attribute VAX Name 
Core Widget Attributes 
height DWT$C_NHEIGHT 


border_width DWT$C_NBORDER_WIDTH 


border DWT$C_NBORDER 
border_pixmap DWT$C_NBORDER_PIXMAP 
background DWT$C_NBACKGROUND 


DWT$C_NBACKGROUND_PIXMAP 
DWT$C_NCOLORMAP 
DWT$C_NSENSITIVE 
DWT$C_NANCESTOR_SENSITIVE 


background_pixmap 
colormap 

sensitive 
ancestor_sensitive 


accelerators DWT$C_NACCELERATORS 
depth DWT$C_NDEPTH 
translations DWT$C_NTRANSLATIONS 


DWT$C_NMAPPED_WHEN_ 
MANAGED 


DWT$C_NSCREEN 
DWT$C_NDESTROY_CALLBACK 


mapped_when_ 
managed 


screen 
destroy_callback 


Common Widget Attributes 


foreground DWT$C_NFOREGROUND 
highlight DWT$C_NHIGHLIGHT 
highlight_pixmap DWT$C_NHIGHLIGHT_PIXMAP 
user_data DWT$C_NUSER_DATA 


direction_r_to_| DWT$C_NDIRECTION_R_TO_L 
font DWT$C_NFONT 
grab_key_syms DWT$C_NGRAB_KEY_SYMS 


grab_merge_ DWT$C_NGRAB_MERGE__ 
translations TRANSLATIONS 
help_callback DWT$C_NHELP_CALLBACK 


VAX Data Type 


uns word 


uns word 
uns longword 
uns longword 
uns longword 
uns longword 
uns longword 
uns byte 
uns byte 


uns longword 
uns longword 
uns longword 
uns byte 


uns longword 
uns longword 


uns longword 
uns longword 
uns longword 
uns longword 
uns byte 

uns longword 
uns longword 
uns longword 


uns longword 


A.14 Menu Popup 


Default 


As large as necessary to 
hold all child widgets 


1 pixel 

Default foreground color 
Null 

Default background color 
Null 

Default color map 

True 


The bitwise AND of the 
parent widget’s sensitive 
and ancestor_sensitive 
attributes 


Null 
Depth of the parent window 
Null 
True 


The parent screen 
Null 


Default foreground color 
Default foreground color 
Null 

Null 

False 

XUI Toolkit font 

Tab key 

See DIALOG BOX CREATE. 


Null 
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A.14 Menu Popup 


Table A—14 (Cont.) Menu Pop-Up Attributes 


Attribute 


VAX Name 


Widget-Specific Attributes 


orientation 


spacing 
adjust_margin 
margin_width 
margin_height 
entry_border 
menu_alignment 
entry_alignment 


menu_packing 


menu_num_columns 
menu_radio 


radio_always_one 


menu_is _ 
homogeneous 


menu_entry_class 


menu_history 
entry_callback 
map_callback 
unmap_cailback 
help_widget 


DWT$C_NORIENTATION 


DWT$C_NSPACING 
DWT$C_NADJUST_MARGIN 
DWT$C_NMARGIN_WIDTH 
DWT$C_NMARGIN_HEIGHT 
DWT$C_NENTRY_BORDER 
DWT$C_NMENU_ALIGNMENT 
DWT$C_NENTRY_ALIGNMENT 


DWT$C_NMENU_PACKING 


DWT$C_NMENU_NUM_COLUMNS 
DWT$C_NMENU_RADIO 


DWT$C_NRADIO_ALWAYS_ONE 


DWT$C_NMENU_IS_ 
HOMOGENEOUS 


DWT$C_NMENU_ENTRY_CLASS 


DWT$C_NMENU_HISTORY 
DWT$C_NENTRY_CALLBACK 
DWT$C_NMAP_CALLBACK 
DWT$C_NUNMAP_CALLBACK 
DWT$C_NHELP_WIDGET 


VAX Data Type 


uns byte 


uns word 
uns byte 
uns word 
uns word 
uns word 
uns byte 
uns byte 


uns byte 


uns longword 
uns byte 


uns byte 
uns byte 


identifier 


uns longword 
uns longword 
uns longword 
uns longword 
uns longword 


Default 


DWT$C_ORIENTATION_ 
VERTICAL 


0 pixels 
True 
3 pixels 
3 pixels 
0 pixels 
True 


DWT$C_ALIGNMENT_ 
BEGINNING 


DWT$C_MENU_PACKING_ 
TIGHT for all menu types 
except for radio boxes. 
Radio boxes default to 
DWT$C_MENU_PACKING_ 
COLUMN. 


1 column 


False except for radio boxes, 
which default to true 


True 


False except for radio boxes, 
which default to true 


Null except for radio 
boxes, which default to 
togglebuttonwidgeiclass 


Null 
Null 
Null 
Null 
Null 





Menu Pulldown 
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See Table A-15 for a summary of menu pull-down widget attributes. 
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A.15 Menu Pulldown 


Table A-15 Menu Pull-Down Attributes 


Attribute VAX Name VAX Data Type Default 

Core Widget Attributes 

Xx DWT$C_NX longword Not supported 

y DWT$C_NY longword Not supported 

width DWT$C_NWIDTH uns word As large as necessary to 
hold all child widgets 

height DWT$C_NHEIGHT uns word As large as necessary to 

hold all child widgets 
border_width DWT$C_NBORDER_WIDTH uns word 1 pixel 


border 
border_pixmap 
background 
background_pixmap 
colormap 

sensitive 


ancestor_sensitive 


accelerators 
depth 
translations 


mapped_when_ 
managed 


screen 
destroy_callback 


DWT$C_NBORDER 
DWT$C_NBORDER_PIXMAP 
DWT$C_NBACKGROUND 
DWT$C_NBACKGROUND_PIXMAP 
DWT$C_NCOLORMAP 
DWT$C_NSENSITIVE 
DWT$C_NANCESTOR_SENSITIVE 


DWT$C_NACCELERATORS 
DWT$C_NDEPTH 
DWT$C_NTRANSLATIONS 


DWT$C_NMAPPED_WHEN_ 
MANAGED 


DWT$C_NSCREEN 
DWT$C_NDESTROY_CALLBACK 


Common Widget Attributes 


foreground 
highlight 
highlight_pixmap 
user_ ‘data 
direction_r_to_| 
font 
grab_key_syms 


grab_merge_ 
translations 


help_callback 


DWT$C_NFOREGROUND 
DWT$C_NHIGHLIGHT 
DWT$C_NHIGHLIGHT_PIXMAP 
DWT$C_NUSER_DATA 
DWT$C_NDIRECTION_R_TO_L 
DWT$C_NFONT 
DWT$C_NGRAB_KEY_SYMS 


DWT$C_NGRAB_MERGE_ 
TRANSLATIONS 


DWT$C_NHELP_CALLBACK 


uns longword 
uns longword 
uns longword 
uns longword 
uns longword 
uns byte 

uns byte 


uns longword 
uns longword 
uns longword 
uns byte 


uns longword 
uns longword 


uns longword 
uns longword 
uns longword 
uns longword 
uns byte 

uns longword 
uns longword 
uns longword 


uns longword 


Default foreground color 
Null 

Default background color 
Null 

Default color map 

True 


The bitwise AND of the 
parent widget’s sensitive 
and ancestor_sensitive 
attributes 


Null 
Depth of the parent window 
Null 
True 


The parent screen 
Null 


Default foreground color 
Default foreground color 

Null 

Null 

False 

XUI Toolkit font 

Tab key 

See DIALOG BOX CREATE. 


Null 


(continued on next page) 


A-31 


A.16 


Summary of Widget Attributes (VAX Binding) 
A.15 Menu Pulidown 


Table A-15 (Cont.) Menu Pull-Down Attributes 


Attribute 
Menu Attributes 


orientation 


spacing 
adjust_margin 
margin_width 
margin_height 
entry_border 
menu_alignment 
entry_alignment 


menu_packing 


menu_num_columns 
menu_radio 


radio_always_one 


menu_is _ 
homogeneous 


menu_entry_class 


menu_history 
entry_callback 
map_callback 
unmap_callback 
help_widget 


VAX Name 


DWT$C_NORIENTATION 


DWT$C_NSPACING 
DWT$C_NADJUST_MARGIN 
DWT$C_NMARGIN_WIDTH 
DWT$C_NMARGIN_HEIGHT 
DWT$C_NENTRY_BORDER 
DWT$C_NMENU_ALIGNMENT 
DWT$C_NENTRY_ALIGNMENT 


DWT$C_NMENU_PACKING 


DWT$C_NMENU_NUM_COLUMNS 
DWT$C_NMENU_RADIO 


DWT$C_NRADIO_ALWAYS_ONE 


DWT$C_NMENU_IS_ 
HOMOGENEOUS 


DWT$C_NMENU_ENTRY_CLASS 


DWT$C_NMENU_HISTORY 
DWT$C_NENTRY_CALLBACK 
DWT$C_NMAP_CALLBACK 
DWT$C_NUNMAP_CALLBACK 
DWT$C_NHELP_WIDGET 


VAX Data Type 


uns byte 


uns word 
uns byte 
uns word 
uns word 
uns word 
uns byte 
uns byte 


uns byte 


uns longword 
uns byte 


uns byte 
uns byte 


identifier 


uns longword 
uns longword 
uns longword 
uns longword 
uns longword 


Default 


DWT$C_ORIENTATION_ 
VERTICAL 


0 pixels 
True 
3 pixels 
3 pixels 
0 pixels 
True 


DWT$C_ALIGNMENT_ 
BEGINNING 


DWT$C_MENU_PACKING_ 
TIGHT for all menu types 
except for radio boxes. 
Radio boxes default to 
DWT$C_MENU_PACKING_ 
COLUMN. 


1 


False except for radio boxes, 
which default to true 


True 


False except for radio boxes, 
which default to true 


Null except for radio 
boxes, which default to 
togglebuttonwidgetclass 


Null 
Null 
Null 
Null 
Null 





Message Box 
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Table A-16 Message Box Attributes 


Attribute 


Core Widget Attributes 


X 


y 


width 

height 

border_width 

border 
border_pixmap 
background 
background_pixmap 
colormap 

sensitive 
ancestor_sensitive 


accelerators 
depth 
translations 


mapped_when_ 
managed 


screen 
destroy_callback 


VAX Name 


DWT$C_NX 
DWT$C_NY 


DWT$C_NWIDTH 
DWT$C_NHEIGHT 
DWT$C_NBORDER_WIDTH 
DWT$C_NBORDER 
DWT$C_NBORDER_PIXMAP 
DWT$C_NBACKGROUND 
DWT$C_NBACKGROUND_PIXMAP 
DWT$C_NCOLORMAP 
DWT$C_NSENSITIVE 
DWT$C_NANCESTOR_SENSITIVE 


DWT$C_NACCELERATORS 
DWT$C_NDEPTH 
DWT$C_NTRANSLATIONS 


DWT$C_NMAPPED_WHEN_ 
MANAGED 


DWT$C_NSCREEN 
DWT$C_NDESTROY_CALLBACK 


Dialog Box Pop-Up Attributes 


foreground 
highlight 
highlight_pixmap 
user_data 
direction_r_to_| 
font 
grab_key_syms 


grab_merge_ 
translations 


help_callback 


DWT$C_NFOREGROUND 
DWT$C_NHIGHLIGHT 
DWT$C_NHIGHLIGHT_PIXMAP 
DWT$C_NUSER_DATA 
DWT$C_NDIRECTION_R_TO_L 
DWT$C_NFONT 
DWT$C_NGRAB_KEY_SYMS 


DWT$C_NGRAB_MERGE_ 
TRANSLATIONS 


DWT$C_NHELP_CALLBACK 


VAX Data Type 


longword 
longword 


uns word 
uns word 
uns word 
uns longword 
uns longword 
uns longword 
uns longword 
uns longword 
uns byte 
uns byte 


uns longword 
uns longword 
uns longword 
uns byte 


uns longword 
uns longword 


uns longword 
uns longword 
uns longword 
uns longword 
uns byte 

uns longword 
uns longword 
uns longword 


uns longword 


A.16 Message Box 


Default 


Determined by the geometry 
manager 


Determined by the geometry 
manager 


5 pixels 

5 pixels 

1 pixel 

Default foreground color 
Null 

Default background color 
Null 

Default color map 

True 


The bitwise AND of the 
parent widget’s sensitive 
and ancestor_sensitive 
attributes 


Null 
Depth of the parent window 
Null 
True 


The parent screen 
Null 


Default foreground color 
Default foreground color 

Null 

Null 

Not supported 

XU! Toolkit font 

Tab key 

See DIALOG BOX CREATE. 


Null 


(continued on next page) 
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A.16 Message Box 


Table A-16 (Cont.) Message Box Attributes 


Attribute 


VAX Name 


Dialog Box Pop-Up Attributes 


units 

title 

style 
map_callback 
unmap_callback 
focus_callback _ 


text_merge_ 
translations 


margin_width 
margin_height 
default_position 
child_overlap 
resize 
take_focus 


no_resize 
auto_unmanage 
default_button 
cancel_button 


DWT$C_NUNITS 
DWT$C_NTITLE 
DWT$C_NSTYLE 
DWT$C_NMAP_CALLBACK 
DWT$C_NUNMAP_CALLBACK 
DWT$C_NFOCUS_CALLBACK 


DWT$C_NTEXT_MERGE_ 
TRANSLATIONS 


DWT$C_NMARGIN_WIDTH 
DWT$C_NMARGIN_HEIGHT 
DWT$C_NDEFAULT_POSITION 
DWT$C_NCHILD_OVERLAP 
DWT$C_NRESIZE 
DWT$C_NTAKE_FOCUS 


DWT$C_NNO_RESIZE 
DWT$C_NAUTO_UNMANAGE 
DWT$C_NDEFAULT_BUTTON 
DWT$C_NCANCEL_BUTTON 


Widget-Specific Attributes 


VAX Data Type 


uns byte 

uns longword 
uns byte 

uns longword 
uns longword 
uns longword 
uns longword 


uns word 
uns word 
uns byte 
uns byte 
uns byte 
uns byte 


uns byte 
uns byte 
uns longword 
uns longword 


Default 


Not supported 
Widget name 
DWT$C_MODAL 
Null 

Null 

Null 

Not supported 


12 pixels 

10 pixels 

False 

Not supported 
DWT$C_SHRINK_WRAP 


True for modal dialog box; 
false for modeless dialog 
box 


True 
True 
Not supported 
Not supported 





label DWT$C_NLABEL uns longword Widget name 
ok_label DWT$C_NOK_LABEL uns longword “Acknowledged” 
yes_callback DWT$C_NYES_ CALLBACK uns longword Null 

Option Menu 
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A.17 Option Menu 


Table A-17 Option Menu Attributes 


Attribute VAX Name VAX Data Type Default 

Core Widget Attributes 

X DWT$C_NX longword Determined by the geometry 
manager 

y DWT$C_NY longword Determined by the geometry 
manager 

width DWT$C_NWIDTH uns word As large as necessary to 
hold all child widgets 

height DWT$C_NHEIGHT uns word As large as necessary to 
hold all child widgets 

border_width DWT$C_NBORDER_WIDTH uns word 1 pixel 


border 
border_pixmap 
background 
background_pixmap 
colormap 

sensitive 
ancestor_sensitive 


accelerators 
depth 
translations 


mapped_when_ 
managed 


screen 
destroy_callback 


DWT$C_NBORDER 
DWT$C_NBORDER_PIXMAP 
DWT$C_NBACKGROUND 
DWT$C_NBACKGROUND_PIXMAP 
DWT$C_NCOLORMAP 
DWT$C_NSENSITIVE 
DWT$C_NANCESTOR_SENSITIVE 


DWT$C_NACCELERATORS 
DWT$C_NDEPTH 
DWT$C_NTRANSLATIONS 


DWT$C_NMAPPED_WHEN_. 
MANAGED 


DWT$C_NSCREEN 
DWT$C_NDESTROY_CALLBACK 


Common Widget Attributes 


uns longword 
uns longword 
uns longword 
uns longword 
uns longword 
uns byte 

uns byte 


uns longword 
uns longword 
uns longword 
uns byte 


uns longword 
uns longword 


Default foreground color 
Null 

Default background color 
Null 

Default color map 

True 


The bitwise AND of the 
parent widget’s sensitive 
and ancestor_sensitive 
attributes 


Null 
Depth of the parent window 
Null 
True 


The parent screen 
Null 





foreground 
highlight 
highlight_pixmap 
user_data 
direction_r_to_| 


DWT$C_NFOREGROUND 
DWT$C_NHIGHLIGHT 
DWT$C_NHIGHLIGHT_PIXMAP 
DWT$C_NUSER_DATA 
DWT$C_NDIRECTION_R_TO_L 


uns longword 
uns longword 
uns longword 
uns longword 
uns byte 


Default foreground color 
Default foreground color 
Null 

Null 

False 
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A.17 Option Menu 


Table A-—17 (Cont.) Option Menu Attributes 


Attribute 


VAX Name 


Common Widget Attributes 


font 


grab_key_syms 


grab_merge_ 
translations 


help_cailback 


Menu Attributes 


orientation 


spacing 
adjust_margin 
margin_width 
margin_height 
entry_border 
menu_alignment 
entry_alignment 


menu_packing 


menu_num_columns 
menu_radio 


radio_always_one 


menu_is_ 
homogeneous 


menu_eniry_class 


menu_history 
entry_callback 
map_callback 
unmap_callback 
help_widget 
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DWT$C_NFONT 


DWT$C_NGRAB_KEY_SYMS 


DWT$C_NGRAB_MERGE_ 
TRANSLATIONS 


DWT$C_NHELP_CALLBACK 


DWT$C_NORIENTATION 


DWT$C_NSPACING 
DWT$C_NADJUST_MARGIN 
DWT$C_NMARGIN_WIDTH 
DWT$C_NMARGIN_HEIGHT. 
DWT$C_NENTRY_BORDER 
DWT$C_NMENU_ALIGNMENT 
DWT$C_NENTRY_ALIGNMENT 


DWT$C_NMENU_PACKING 


DWT$C_NMENU_NUM_COLUMNS 
DWT$C_NMENU_RADIO 


DWT$C_N RADIO_ALWAYS_ONE 


DWT$C_NMENU_IS_ 
HOMOGENEOUS 


DWT$C_NMENU_ENTRY_CLASS 


DWT$C_NMENU_HISTORY 
DWT$C_NENTRY_CALLBACK 
DWT$C_NMAP_CALLBACK 
DWT$C_NUNMAP_CALLBACK 
DWT$C_NHELP_WIDGET 


VAX Data Type 


uns longword 


uns longword 
uns longword 


uns longword 


uns byte 


uns word 
uns byte 
uns word 
uns word 
uns word 
uns byte 
uns byte 


uns byte 


uns longword 
uns byte 


uns byte 
uns byte 


identifier 


uns longword 
uns longword 
uns longword 
uns longword 
uns longword 


Default 


The default XUI Toolkit font; 
used only by gadget children 


Tab key 
See DIALOG BOX CREATE. 


Null 


DWT$C_ORIENTATION_ 
VERTICAL 


0 pixels 
True 
3 pixels 
0 pixels 
0 pixels 
True 


DWT$C_ALIGNMENT_ 
BEGINNING 


DWT$C_MENU_PACKING_ 
TIGHT for all menu types 
except for radio boxes. 
Radio boxes default to 
DWT$C_MENU_PACKING_ 
COLUMN. 


1 


False except for radio boxes, 
which default to true 


True 


False except for radio boxes, 
which default to true 


Null except for radio 
boxes, which default to 
togglebuttonwidgetclass 


Null 
Null 
Nuil 
Null 
Null 
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Table A-17 (Cont.) Option Menu Attributes 


Attribute 


VAX Name 


Widget-Specific Attributes 


label 
sub_menu_id 


DWT$C_NLABEL 
DWT$C_NSUB_MENU_ID 


VAX Data Type 


uns. longword 
uns longword 


A.17 Option Menu 


Default 


Widget name 
Zero 





Pull Down Menu Entry 


See Table A-18 for a summary of pull-down menu entry widget 


attributes. 


Table A-18 Pull-Down Menu Entry Attributes 


Attribute 


Core Widget Attributes 


Xx 


width 


height 


border_width 

border 
border_pixmap 
background 
background_pixmap 
colormap 

sensitive 
ancestor_sensitive 


accelerators 
depih 


VAX Name 


DWT$C_NX 
DWT$C_NY 


DWT$C_NWIDTH 


DWT$C_NHEIGHT 


DWT$C_NBORDER_WIDTH 
DWT$C_NBORDER 
DWT$C_NBORDER_PIXMAP 
DWT$C_NBACKGROUND 
DWT$C_NBACKGROUND_PIXMAP 
DWT$C_NCOLORMAP 
DWT$C_NSENSITIVE 
DWT$C_NANCESTOR_SENSITIVE 


DWT$C_NACCELERATORS 
DWT$C_NDEPTH 


VAX Data Type 


longword 
longword 


uns word 


uns word 


uns word 
uns longword 
uns longword 
uns longword 
uns longword 
uns longword 
uns byte 
uns byte 


uns longword 
uns longword 


Default 


Determined by the geometry 
manager 


Determined by the geomeiry 
manager 


Width of the label or pixmap, 
plus the hotspot width, plus 
two times margin_width 


Height of the label or 
pixmap, plus two times 
margin_height 


O pixels 

Default foreground color 
Null 

Default background color 
Null 

Default color map 

True 


The bitwise AND of the 
parent widget’s sensitive 
and ancestor_sensitive 
attributes 

Null 


Depth of the parent window 
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Table A-18 (Cont.) Pull-Down Menu Entry Attributes 


Attribute 


Core Widget Attributes 


translations 


mapped_when_ 
managed 


screen 
destroy_callback 


VAX Name 


DWT$C_NTRANSLATIONS 


DWT$C_NMAPPED_WHEN_ 
MANAGED 


DWT$C_NSCREEN 
DWT$C_NDESTROY_CALLBACK 


Common Widget Attributes 


foreground 
highlight 
highlight_pixmap 
user_data 
direction_r_to_| 
font 
grab_key_syms 


grab_merge_ 
translations 


help_callback 


Label Attributes 


label_type 
label 
margin_width 


margin_height 
alignment 


pixmap 
margin_left 
margin_right 
margin_top 
margin_bottom 
conform_to_text 
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DWT$C_NFOREGROUND 
DWT$C_NHIGHLIGHT 
DWT$C_NHIGHLIGHT_PIXMAP 
DWT$C_NUSER_DATA 
DWT$C_NDIRECTION_R_TO_L 
DWT$C_NFONT 
DWT$C_NGRAB_KEY_SYMS 


DWT$C_NGRAB_MERGE_ 
TRANSLATIONS 


DWT$C_NHELP_CALLBACK 


DWT$C_NLABEL_TYPE 
DWT$C_NLABEL 
DWT$C_NMARGIN_WIDTH 


DWT$C_NMARGIN_HEIGHT 
DWT$C_NALIGNMENT 


DWT$C_NPIXMAP 
DWT$C_NMARGIN_LEFT 
DWT$C_NMARGIN_RIGHT 
DWT$C_NMARGIN_TOP 
DWT$C_NMARGIN_BOTTOM 
DWT$C_NCONFORM_TO_TEXT 


VAX Data Type 


uns longword 
uns byte 


uns longword 
uns longword 


uns longword 
uns longword 
uns longword 
uns longword 
uns byte 

uns longword 
uns longword 
uns longword 


uns longword 


uns byte 
uns longword 
uns word 


uns word 
uns byte 


uns longword 
uns word 
uns word 
uns word 
uns word 
uns byte 


Default 


Null 
True 


The parent screen 
Null 


Default foreground color 
Default foreground color 

Null 

Null 

False 

XUI Toolkit font 

Tab key 

See DIALOG BOX CREATE. 


Null 


DWT$C_CSTRNG 
Widget name 


2 pixels for text; 0 pixels for 
pixmap 


2 pixels for text; 0 pixels for 
pixmap 


DWT$C_ALIGNMENT_ 
CENTER 


Null 

0 pixels 
0 pixels 
0 pixels 
0 pixels 


True if width and height 
are zero; false if width and 
height are not zero 
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Table A-18 (Cont.) Pull-Down Menu Eniry Attributes 


Attribute 


Summary of Widget Attributes (VAX Binding) 
A.18 Pull Down Menu Entry 


VAX Name 


Widget-Specific Attributes 


sub_menu_id 
activate_callback 
pulling_callback 
hot_spot_pixmap 


DWT$C_NSUB_MENU_ID 
DWT$C_NACTIVATE_CALLBACK 
DWT$C_NPULLING_CALLBACK 
DWT$C_NHOT_SPOT_PIXMAP 


VAX Data Type 


uns longword 
uns longword 
uns longword 
uns longword 


Default 


Null 
Null 
Null 
Null 





Push Button 


See Table A-19 for a summary of push button widget attributes. 


Table A-19 Push Button Attributes 


Attribute 


Core Widget Attributes 


X 


width 


height 


border_width 

border 
border_pixmap 
background 
background_pixmap 
colormap 

sensitive 
ancestor_sensitive 


accelerators 


VAX Name 


DWT$C_NX 
DWT$C_NY 


DWT$C_NWIDTH 


DWT$C_NHEIGHT 


DWT$C_NBORDER_WIDTH 
DWT$C_NBORDER 
DWT$C_NBORDER_PIXMAP 
DWT$C_NBACKGROUND 
DWT$C_NBACKGROUND_PIXMAP 
DWT$C_NCOLORMAP 
DWT$C_NSENSITIVE 
DWT$C_NANCESTOR_SENSITIVE 


DWT$C_NACCELERATORS 


VAX Data Type 


longword 
longword 


uns word 


uns word 


uns word 
uns longword 
uns longword 
uns longword 
uns longword 
uns longword 
uns byte 
uns byte 


uns longword 


Default 


Determined by the geometry 
manager 


Determined by the geometry 
manager 


Width of the label or pixmap, 
plus two times margin_ 
width 


Height of the label or 
pixmap, plus two times 
margin_height 


1 pixel 

Default foreground color 
Null 

Default background color 
Null 

Default color map 

True 


The bitwise AND of the 
parent widget’s sensitive 
and ancestor_sensitive 
attributes 


Null 
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Table A-19 (Cont.) Push Button Attributes 


Attribute 


VAX Name 


VAX Data Type 


Default 





Core Widget Attributes 


depth 
translations 


mapped_when_ 


managed 
screen 


destroy_callback 


DWT$C_NDEPTH 
DWT$C_NTRANSLATIONS 


DWT$C_NMAPPED_WHEN_ 
MANAGED 


DWT$C_NSCREEN 


DWT$C_NDESTROY_CALLBACK 


Common Widget Attributes 


foreground 
highlight 


highlight_pixmap 


user_data 


direction_r_to_| 


font 


grab_key_syms 


grab_merge_ 
translations 


help_caliback 


Label Attributes 


label_type 
label 
margin_width 


margin_height 
alignment 


pixmap 
margin_left 
margin_right 
margin_top 


margin_bottom 
conform_to_text 


DWT$C_NFOREGROUND 
DWT$C_NHIGHLIGHT 
DWT$C_NHIGHLIGHT_PIXMAP 
DWT$C_NUSER_DATA 
DWT$C_NDIRECTION_R_TO_L 
DWT$C_NFONT 
DWT$C_NGRAB_KEY_SYMS 


DWT$C_NGRAB_MERGE_ 
TRANSLATIONS 


DWT$C_NHELP_CALLBACK 


DWT$C_NLABEL_TYPE 
DWT$C_NLABEL 
DWT$C_NMARGIN_WIDTH 


DWT$C_NMARGIN_HEIGHT 
DWT$C_NALIGNMENT 


DWT$C_NPIXMAP 
DWT$C_NMARGIN_LEFT 
DWT$C_NMARGIN_RIGHT 
DWT$C_NMARGIN_TOP 
DWT$C_NMARGIN_BOTTOM 
DWT$C_NCONFORM_TO_TEXT 


uns longword 
uns longword 
uns byte 


uns longword 
uns longword 


uns longword 
uns longword 
uns longword 
uns longword 
uns byte 

uns longword 
uns longword 
uns longword 


uns longword 


uns byte 
uns longword 
uns word 


uns word 
uns byte 


uns longword 
uns word 
uns word 
uns word 
uns word 
uns byte 


Depth of the parent window 
Null 
True 


The parent screen 
Null 


Default foreground color 
Default foreground color 
Null 

Null 

False 

XUI Toolkit font 

Tab key 

See DIALOG BOX CREATE. 


Null 


DWT$C_CSTRING 
Widget name 


2 pixels for text; 0 pixels for 
pixmap 


2 pixels for text; 0 pixels for 
pixmap 


DWT$C_CENTER_ 
ALIGNMENT 


Null 

0 pixels 
0 pixels 
0 pixels 
0 pixels 


True if width and height 
are zero; false if width and 
height are not zero 
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Table A-19 (Cont.) Push Button Attributes 


A.19 Push Button 








Attribute VAX Name VAX Data Type Default 
Widget-Specific Attributes 
border_highlight DWT$C_NBORD_HIGHLIGHT uns byte False 
fill_highlight DWT$C_NFILL_HIGHLIGHT uns byte False 
activate_callback DWT$C_NACTIVATE_CALLBACK uns longword Null 
arm_callback DWT$C_NARM_CALLBACK uns longword Null 
disarm_callback DWT$C_NDISARM_CALLBACK uns longword Null 
accelerator_text DWT$C_NACCELERATOR_TEXT uns longword Null 
button_accelerator DWT$C_NBUTTON__ uns longword Null 
ACCELERATOR 
shadow DWT$C_NSHADOW uns byte True 
Radio Box 


See Table A—20 for a summary of radio box widget attributes. 


Table A-20 Radio Box Attributes 


Attribute 


Core Widget Attributes 


x< 


< 


width 
height 


border_width 

border 
border_pixmap 
background 
background_pixmap 
colormap 

sensitive 
ancestor_sensitive 


VAX Name 


DWT$C_NX 
DWT$C_NY 
DWT$C_NWIDTH 
DWT$C_NHEIGHT 


DWT$C_NBORDER_WIDTH 
DWT$C_NBORDER 
DWT$C_NBORDER_PIXMAP 
DWT$C_NBACKGROUND 
DWT$C_NBACKGROUND_PIXMAP 
DWT$C_NCOLORMAP 
DWT$C_NSENSITIVE 
DWT$C_NANCESTOR_SENSITIVE 


VAX Data Type 


longword 
longword 
uns word 
uns word 


uns word 
uns longword 
uns longword 
uns longword 
uns longword 
uns longword 
uns byte 
uns byte 


Default 


Determined by the geometry 
manager 


Determined by the geometry 
manager 


As large as necessary to 
hold all child widgets 


As large as necessary to 
hold all child widgets 


1 pixel 

Default foreground color 
Null 

Default background color 
Null 

Default color map 

True 


The bitwise AND of the 
parent widget’s sensitive 
and ancestor_sensitive 
attributes 
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A.20 Radio Box 


Table A-20 (Cont.) Radio Box Attributes 
Attribute VAX Name 


Core Widget Attributes 


accelerators DWT$C_NACCELERATORS 
depth DWT$C_NDEPTH 
translations DWT$C_NTRANSLATIONS 


DWT$C_NMAPPED_WHEN_ 
MANAGED 


DWT$C_NSCREEN 
DWT$C_NDESTROY_CALLBACK 


mapped_when_ 
managed 


screen 
destroy_callback 


Common Widget Attributes 


foreground DWT$C_NFOREGROUND 
highlight DWT$C_NHIGHLIGHT 
highlight_pixmap DWT$C_NHIGHLIGHT_PIXMAP 
user_data DWT$C_NUSER_DATA 


direction_r_to_| DWT$C_NDIRECTION_R_TO_L 
font DWT$C_NFONT 
DWT$C_NGRAB_KEY_SYMS 


DWT$C_NGRAB_MERGE_ 
TRANSLATIONS 


DWT$C_NHELP_CALLBACK 


grab_key_syms 


grab_merge_ 
translations 


help_ callback 


Widget-Specific Attributes 


orientation DWT$C_NORIENTATION 


DWT$C_NSPACING 
DWT$C_NADJUST_MARGIN 
DWT$C_NMARGIN_WIDTH 
DWT$C_NMARGIN_HEIGHT 
DWT$C_NENTRY_BORDER 
DWT$C_NMENU_ALIGNMENT 
DWT$C_NENTRY_ALIGNMENT 


spacing 
adjust_margin 
margin_width 
margin_height 
entry_border 
menu_alignment 
entry_alignment 
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VAX Data Type 


uns longword 
uns longword 
uns longword 
uns byte 


uns longword 
uns longword 


uns longword 
uns longword 
uns longword 
uns longword 
uns byte 

uns longword 
uns longword 
uns longword 


uns longword 


uns byte 


uns word 
uns byte 
uns word 
uns word 
uns word 
uns byte 
uns byte 


Default 


Null 
Depth of the parent window 
Null 
True 


The parent screen 
Null 


Default foreground color 
Default foreground color 

Null 

Null 

False 

XUI Toolkit font 

Tab key 

See DIALOG BOX CREATE. 


Null 


DWT$C_ORIENTATION_ 
VERTICAL 


1 pixel 

True 

3 pixels 

3 pixels 

0 pixels 

True 
DWT$C_ALIGNMENT_ 
BEGINNING 
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Table A-20 (Cont.) Radio Box Attributes 


Attribute 


VAX Name 


Widget-Specific Attributes 


menu_packing 


menu_num_columns 
menu_radio 


radio_always_one 


menu_is_ 
homogeneous 


menu_entry_class 


menu_history 


DWT$C_NMENU_PACKING 


DWT$C_NMENU_NUM_COLUMNS 
DWT$C_NMENU_RADIO 


DWT$C_NRADIO_ALWAYS_ONE 


DWT$C_NMENU_IS_ 
HOMOGENEOUS 


DWT$C_NMENU_ENTRY_CLASS 


DWT$C_NMENU_HISTORY 


VAX Data Type 


uns byte 


uns longword 
uns byte 


uns byte 
uns byte 


identifier 


uns longword 


A.20 Radio Box 


Default 


DWT$C_MENU_PACKING_ 
TIGHT for all menu types 
except for radio boxes. 
Radio boxes default to 
DWT$C_MENU_PACKING_ 
COLUMN. 


1 


False except for radio boxes, 
which default to true 


True 


False except for radio boxes, 
which default to true 

Null except for radio 

boxes, which default to 
togglebuttonwidgetclass 


Null 





entry_callback DWT$C_NENTRY_CALLBACK uns longword Null 
map_callback DWT$C_NMAP_CALLBACK uns longword Null 
unmap_callback DWT$C_NUNMAP_CALLBACK uns longword Null 
help_widget DWT$C_NHELP_WIDGET uns longword Null 
Scale 


See Table A~21 for a summary of scale widget attributes. 


Table A-21 Scale Attributes 


Attribute 


Core Widget Attributes 


X 


width 


VAX Name 


DWT$C_NX 
DWT$C_NY 


DWT$C_NWIDTH 


VAX Data Type 


longword 
longword 


uns word 


Default 


Determined by the geometry. 
manager 


Determined by the geometry 
manager 


Calculated based on the 
scale width or height, 
the label widths, and the 
orientation 
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A.21 Scale 


Table A-21 (Cont.) Scale Attributes 


Attribute 


Core Widget Attributes 


height 


border_width 

border 
border_pixmap 
background 
background_pixmap 
colormap 

sensitive 
ancestor_sensitive 


accelerators 
depth 
translations 


mapped_when_ 
managed 


screen 
destroy_callback 


VAX Name 


DWT$C_NHEIGHT 


DWT$C_NBORDER_WIDTH 
DWT$C_NBORDER 
DWT$C_NBORDER_PIXMAP 
DWT$C_NBACKGROUND 
DWT$C_NBACKGROUND_PIXMAP 
DWT$C_NCOLORMAP 
DWT$C_NSENSITIVE 
DWT$C_NANCESTOR_SENSITIVE 


DWT$C_NACCELERATORS 
DWT$C_NDEPTH 
DWT$C_NTRANSLATIONS 


DWT$C_NMAPPED_WHEN_ 
MANAGED 


DWT$C_NSCREEN 
DWT$C_NDESTROY_CALLBACK 


Common Widget Attributes 


foreground 
highlight 
highlight_pixmap 
user_data 
direction_r_to_| 
font 
grab_key_syms 


grab_merge_ 
translations 


help callback 


DWT$C_NFOREGROUND 
DWT$C_NHIGHLIGHT 
DWT$C_NHIGHLIGHT_PIXMAP 
DWT$C_NUSER_DATA 
DWT$C_NDIRECTION_R_TO_L 
DWT$C_NFONT 
DWT$C_NGRAB_KEY_SYMS 


DWT$C_NGRAB_MERGE_ 
TRANSLATIONS 


DWT$C_NHELP_CALLBACK 


VAX Data Type 


uns word 


uns word 
uns longword 
uns longword 
uns longword 
uns longword 
uns longword 
uns byte 
uns byte 


uns longword 
uns longword 
uns longword 
uns byte 


uns longword 
uns longword 


uns longword 
uns longword 
uns longword 
uns longword 
uns byte 

uns longword 
uns longword 
uns longword 


uns longword 


Default 


Calculated based on the 
scale width or height, 
the label widths, and the 
orientation 


0 pixels 


Default foreground color 


Null 

Default background color 
Null 

Default color map 

True 


The bitwise AND of the 
parent widget’s sensitive 
and ancestor_sensitive 
attributes 


Null 
Depth of the parent window 
Null 
True 


The parent screen 
Null 


Default foreground color 
Default foreground color 

Null 

Nuil 

False 

XUI Toolkit font 

Tab key 

See DIALOG BOX CREATE. 


Null 
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A.21 Scale 

Table A-21 (Cont.) Scale Attributes 

Attribute VAX Name VAX Data Type Default 

Widget-Specific Attributes 

value DWT$C_NVALUE uns longword Zero 

title DWT$C_NTITLE uns longword Null 

orientation DWT$C_NORIENTATION uns byte DWT$C_ORIENTATION_ 
HORIZONTAL 

scale_width DWT$C_NSCALE_WIDTH uns word 20 pixels for vertical scales; 
calculated for horizontal 
scales. 

scale_height DWT$C_NSCALE_HEIGHT uns word 20 pixels for horizontal 
scales; calculated for vertical 
scales 

min_value DWT$C_NMIN_VALUE uns longword Zero 

max_value DWT$C_NMAX_VALUE uns longword 100 

decimal_points DWT$C_NDECIMAL_POINTS uns byte Zero 

show_value DWT$C_NSHOW_VALUE uns byte True 

slider_pixmap DWT$C_NSLIDER_PIXMAP uns longword Null 

drag_callback DWT$C_NDRAG_CALLBACK uns longword Null 

value_changed_ DWT$C_NVALUE_CHANGED uns longword Null 

callback CALLBACK 

Scroll Bar 


See Table A~22 for a summary of scroll bar widget attributes. 


Table A-22 Scroll Bar Attributes 


Attribute 


Core Widget Attributes 


X 


width 


height 


VAX Name 


DWT$C_NX 
DWT$C_NY 


DWT$C_NWIDTH 


DWT$C_NHEIGHT 


VAX Data Type 


longword 
longword 


uns word 


uns word 


Default 


Determined by the geometry 
manager 


Determined by the geometry 
manager 


For vertical scroll bars, 17 
pixels; for horizontal scroll 
bars, the width of the parent 
minus 17 pixels 


For horizontal scroll bars, 

17 pixels; for vertical scroll 
bars, the height of the parent 
minus 17 pixels 
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A.22 Scroll Bar 


Table A-22 (Cont.) Scroll Bar Attributes 
Attribute VAX Name 


Core Widget Attributes 


border_width 
border 


DWT$C_NBORDER_WIDTH 
DWT$C_NBORDER 
DWT$C_NBORDER_PIXMAP 
DWT$C_NBACKGROUND 
DWT$C_NBACKGROUND_PIXMAP 
DWT$C_NCOLORMAP 
DWT$C_NSENSITIVE 
DWT$C_NANCESTOR_SENSITIVE 


border_pixmap 
background 
background_pixmap 
colormap 

sensitive 
ancestor_sensitive 


accelerators DWT$C_NACCELERATORS 
depth DWT$C_NDEPTH 
DWT$C_NTRANSLATIONS 


DWT$C_NMAPPED_WHEN_ 
MANAGED 


DWT$C_NSCREEN 
DWT$C_NDESTROY_CALLBACK 


translations 


mapped_when_. 
managed 


screen 
destroy_callback 


Common Widget Attributes 


foreground DWT$C_NFOREGROUND 
highlight DWT$C_NHIGHLIGHT 

- highlight_pixmap DWT$C_NHIGHLIGHT_PIXMAP 
user_data DWT$C_NUSER_DATA 


direction_r_to_| DWT$C_NDIRECTION_R_TO_L 
font DWT$C_NFONT 


grab_key_syms DWT$C_NGRAB_KEY_SYMS 


grab_merge_ DWT$C_NGRAB_MERGE_ 
translations TRANSLATIONS 
help_ callback DWT$C_NHELP_CALLBACK 


Widget-Specific Attributes 


int_value DWT$C_NVALUE 
min_value DWT$C_NMIN_VALUE 
max_value DWT$C_NMAX_VALUE 
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VAX Data Type 


uns word 
uns longword 
uns longword 
uns longword 
uns longword 
uns longword 
uns byte 
uns byte 


uns longword 


~ uns longword 


uns longword 
uns byte 


uns longword 
uns longword 


uns longword 
uns longword 
uns longword 
uns longword 
uns byte 

uns longword 
uns longword 
uns longword 


uns longword 


uns longword 
uns longword 
uns longword 


Default 


1 pixel 

Default foreground color 
Null 

Default background color 
Null 

Default color map 

True 


The bitwise AND of the 
parent widget’s sensitive 
and ancestor_sensitive 
attributes 


Null 
Depth of the parent window 
Null 
True 


The parent screen 
Null 


Default foreground color 
Default foreground color 

Null 

Null 

False 

Not supported 

Tab key 

See DIALOG BOX CREATE. 


Null 


Zero 
Zero 
100 
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Table A-22 (Cont.) Scroll Bar Attributes 


Attribute 


VAX Name 


Widget-Specific Attributes 


orientation 


translations 
translations2 
shown 

inc 

page_inc 
unit_inc_callback 
unit_dec_callback 
page_inc_callback 
page_dec_callback 
to_top_callback 
to_bottom_callback 


drag_callback 


value_changed_ 
callback 


DWT$C_NORIENTATION 


DWT$C_NTRANSLATIONS1 
DWT$C_NTRANSLATIONS2 
DWT$C_NSHOWN 

DWT$C_NINC 
DWT$C_NPAGE_INC 
DWT$C_NUNIT_INC_CALLBACK 
DWT$C_NUNIT_DEC_CALLBACK 
DWT$C_NPAGE_INC_CALLBACK 
DWT$C_NPAGE_DEC_CALLBACK 
DWT$C_NTO_TOP_CALLBACK 


DWT$C_NTO_BOTTOM_ 
CALLBACK 


DWT$C_NDRAG_CALLBACK 


DWT$C_NVALUE_CHANGED_ 
CALLBACK 


VAX Data Type 


uns byte 


uns longword 
uns longword 
uns longword 
uns longword 
uns. longword 
uns longword 
uns longword 
uns longword 
uns longword 
uns longword 
uns longword 


uns longword 
uns longword 


A.22 Scroll Bar 


Default 


DWT$C_ORIENTATION_ 
HORIZONTAL 


Null 
Null 
10 units 
10 units 
10 units 
Null 
Null 
Nuil 
Null 
Null 
Null 


Null 
Null 





Scroll Window 


See Table A—23 for a summary of scroll window widget attributes. 


Table A-23 Scroll Window Attributes 


Attribute 


Core Widget Attributes 


X 


y 


width 

height 
border_width 
border 
border_pixmap 
background 


VAX Name 


DWT$C_NX 
DWT$C_NY 


DWT$C_NWIDTH 
DWT$C_NHEIGHT 
DWT$C_NBORDER_WIDTH 
DWT$C_NBORDER 
DWT$C_NBORDER_PIXMAP 
DWT$C_NBACKGROUND 


VAX Data Type 


longword 
longword 


uns word 
uns word 
uns word 
uns longword 
uns longword 
uns longword 


Default 


Determined by the geometry 
manager 


Determined by the geometry 
manager 


Widget specific 

Widget specific 

1 pixel 

Default foreground color 
Null 

Default background color 
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A.23 Scroll Window 


Table A-—23 (Cont.) Scroll Window Attributes 
Attribute VAX Name 


Core Widget Attributes 


background_pixmap 
colormap 


DWT$C_NBACKGROUND_PIXMAP 
DWT$C_NCOLORMAP 
DWT$C_NSENSITIVE 
DWT$C_NANCESTOR_SENSITIVE 


sensitive 
ancestor_sensitive 


accelerators DWT$C_NACCELERATORS 
depth DWT$C_NDEPTH 
DWT$C_NTRANSLATIONS 


DWT$C_NMAPPED_WHEN_ 
MANAGED 


DWT$C_NSCREEN 
DWT$C_NDESTROY_CALLBACK 


translations 


mapped_when_ 
managed 


screen 
destroy_callback 


Common Widget Attributes 


foreground DWT$C_NFOREGROUND 
highlight DWT$C_NHIGHLIGHT 
highlight_pixmap DWT$C_NHIGHLIGHT_PIXMAP 
user_data DWT$C_NUSER_DATA 


direction_r_to_| DWT$C_NDIRECTION_R_TO_L 
font DWT$C_NFONT 
grab_key_syms DWT$C_NGRAB_KEY_SYMS 


grab_merge_ DWT$C_NGRAB_MERGE 
translations TRANSLATIONS 
help_callback DWT$C_NHELP_CALLBACK 
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VAX Data Type 


uns longword 
uns longword 
uns byte 
uns byte 


uns longword 
uns longword 
uns longword 
uns byte 


uns longword 
uns longword 


uns longword 
uns longword 
uns longword 
uns longword 
uns byte 

uns longword 
uns longword 
uns longword 


uns longword 


Default 


Null 
Default color map 
True 


The bitwise AND of the 
parent widget’s sensitive 
and ancestor_sensitive 
attributes 


Null 
Depth of the parent window 
Null 
True 


The parent screen 
Null 


Default foreground color 
Default foreground color 

Null 

Null 

False 

Not supported 

Tab key 

See DIALOG BOX CREATE. 


Not supported 
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A.23 Scroll Window 


Table A-23 (Cont.) Scroll Window Attributes 
Attribute VAX Name VAX Data Type Default 


Widget-Specific Attributes 





h_scroll DWT$C_NHORIZONTAL_SCROLL_ uns longword Null 
BAR 

v_scroll DWT$C_NVERTICAL_SCROLL_ uns longword Null 
BAR 

work_window DWT$C_NWORK_WINDOW uns longword Null 

shown_value_ DWT$C_NSHOWN_VALUE_ uns byte True 

automatic_horiz AUTOMATIC_HORIZ 

shown_value_ DWT$C_NSHOWN_VALUE _ uns byte True 

automatic_vert AUTOMATIC_VERT 





A.24 Selection 


See Table A—24 for a summary of selection widget attributes. 


Table A-24 Selection Attributes 
Attribute VAX Name VAX Data Type Default 
Core Widget Attributes 


x DWT$C_NX longword Centered in the parent 
window 

y DWT$C_NY longword Centered in the parent 
window 

width DWT$C_NWIDTH uns word Width of the list box, plus the 


width of the push buttons, 
plus three times margin_ 
width 


height DWT$C_NHEIGHT uns word Height of the list box, plus 
the height of the text edit 
field, plus the height of 
the label, plus three times 
margin_height 


border_width DWT$C_NBORDER_WIDTH uns word 1 pixel 

border DWT$C_NBORDER uns longword Default foreground color 
border_pixmap DWT$C_NBORDER_PIXMAP uns longword Null 

background DWT$C_NBACKGROUND uns longword Default background color 
background_pixmap DWT$C_NBACKGROUND_PIXMAP _ uns longword Null 

colormap DWT$C_NCOLORMAP uns longword Default color map 
sensitive DWT$C_NSENSITIVE uns byte True 
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A.24 Selection 


Table A-24 (Cont.) Selection Attributes 
Attribute VAX Name 


Core Widget Attributes 


ancestor_sensitive 


accelerators 
depth 
translations 


mapped_when_ 
managed 


screen 
destroy_callback 


DWT$C_NANCESTOR_SENSITIVE 


DWT$C_NACCELERATORS 
DWT$C_NDEPTH 
DWT$C_NTRANSLATIONS 


DWT$C_NMAPPED_WHEN_ 
MANAGED 


DWT$C_NSCREEN 
DWT$C_NDESTROY_CALLBACK 


Dialog Box Pop-Up Attributes 


foreground 
highlight 
highlight_pixmap 
user_data 
direction_r_to_| 
font 
grab_key_syms 


grab_merge_ 
translations 


help_callback 
units 

style 
focus_callback 


text_merge_ 
translations 


margin_width 
margin_height 
default_position 
child_overlap 
resize 


no_resize 
title 
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DWT$C_NFOREGROUND 
DWT$C_NHIGHLIGHT 
DWT$C_NHIGHLIGHT_PIXMAP 
DWT$C_NUSER_DATA 
DWT$C_NDIRECTION_R_TO_L 
DWT$C_NFONT 
DWT$C_NGRAB_KEY_SYMS 


DWT$C_NGRAB_MERGE_ 
TRANSLATIONS 


DWT$C_NHELP_CALLBACK 
DWT$C_NUNITS 
DWT$C_NSTYLE 
DWT$C_NFOCUS_CALLBACK 


DWT$C_NTEXT_MERGE_ 
TRANSLATIONS 


DWT$C_NMARGIN_WIDTH 
DWT$C_NMARGIN_HEIGHT 
DWT$C_NDEFAULT_POSITION 
DWT$C_NCHILD_OVERLAP 
DWT$C_NRESIZE 


DWT$C_NNO_RESIZE 
DWT$C_NTITLE 


VAX Data Type 


uns byte 


uns longword 
uns longword 
uns longword 
uns byte 


uns longword 
uns longword 


uns longword 
uns longword 
uns longword 
uns longword 
uns byte 

uns longword 
uns longword 
uns longword 


uns longword 
uns byte 
uns byte 
uns longword 
uns longword 


uns word 
uns word 
uns byte 
uns byte 
uns byte 


uns byte 
uns longword 


Default 


The bitwise AND of the 
parent widget’s sensitive 
and ancestor_sensitive 
attributes 


Null 
Depth of the parent window 
Null 
True 


The parent screen 
Null 


Default foreground color 
Default foreground color 

Null 

Null 

False 

XUI Toolkit font 

Tab key 

See DIALOG BOX CREATE. 


Null 
DWT$C_FONT_UNITS 
DWT$C_MODELESS 
Null 

Null 


5 pixels 
5 pixels 
False 
True 


DWT$C_RESIZE_GROW_ 
ONLY 


True 
“Open” 
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Table A-24 (Cont.) Selection Attributes 


Attribute 


VAX Name 


VAX Data Type 


A.24 Selection 


Default 





Dialog Box Pop-Up Attributes 


map_callback 


unmap_callback 


DWT$C_NMAP_CALLBACK 
DWT$C_NUNMAP_CALLBACK 


uns longword 
uns longword 


Null 
Null 





take_focus DWT$C_NTAKE_FOCUS uns byte True for modal dialog box; 
false for modeless dialog 
box 

auto_unmanage DWT$C_NAUTO_UNMANAGE uns byte True 

default_button DWT$C_NDEFAULT_BUTTON uns longword Null 

cancel_button DWT$C_NCANCEL_BUTTON uns longword Null 

Widget-Specific Attributes 

label DWT$C_NLABEL uns longword “Items” 

value DWT$C_NVALUE uns longword Null string 

selection_label DWT$C_NSELECTION_LABEL uns longword “Selection” 

ok_label DWT$C_NOK_LABEL uns longword “OK” 

cancel_label | DWT$C_NCANCEL_LABEL uns longword “Cancel” 

activate_callback DWT$C_NACTIVATE_CALLBACK uns longword Null 

cancel_callback DWT$C_NCANCEL_CALLBACK uns longword Null 

no_match_callback DWT$C_NNO_MATCH_CALLBACK _ uns longword Null 

visible_item_count DWT$C_NVISIBLE_ITEMS_COUNT _ uns longword 8 items 

items DWT$C_NITEMS uns longword Null 

item_count DWT$C_NITEMS_COUNT uns longword 0 items 

must_match DWT$C_NMUST_MATCH uns byte False 

Separator 


See Table A-25 for a summary of separator widget attributes. 


Table A-25 Separator Attributes 


Attribute 


Core Widget Attributes 


X 


< 


width 


VAX Name 


DWT$C_NX 
DWT$C_NY 


DWT$C_NWIDTH 


VAX Data Type 


longword 
longword 


uns word 


Default 


Determined by the geometry 
manager 


Determined by the geometry 
manager 


3 pixels 





(continued on next page) 


A-51 


Summary of Widget Attributes (VAX Binding) 


A.25 Separator 


Table A-25 (Cont.) Separator Attributes 


VAX Data Type 


Default 








Attribute — VAX Name 

Core Widget Attributes 

height DWT$C_NHEIGHT uns word 3 pixels 

border_width DWT$C_NBORDER_WIDTH uns word 0 pixels 

border DWT$C_NBORDER uns longword Default foreground color 


border_pixmap 


background 


background_pixmap 


colormap 
sensitive 


ancestor_sensitive 


accelerators 
depth 
transiations 


mapped_when_ 


managed 
screen 


destroy_callback 


DWT$C_NBORDER_PIXMAP 
DWT$C_NBACKGROUND 
DWT$C_NBACKGROUND_PIXMAP 
DWT$C_NCOLORMAP 
DWT$C_NSENSITIVE 
DWT$C_NANCESTOR_SENSITIVE 


DWT$C_NACCELERATORS 
DWT$C_NDEPTH 
DWT$C_NTRANSLATIONS 


DWT$C_NMAPPED_WHEN_ 
MANAGED 


DWT$C_NSCREEN 
DWT$C_NDESTROY_CALLBACK 


Common Widget Attributes 


uns longword 
uns longword 
uns longword 
uns longword 
uns byte 
uns byte 


uns longword 
uns longword 
uns longword 
uns byte 


uns longword 
uns longword 


Null 

Default background color 
Null 

Default color map 

True 


The bitwise AND of the 
parent widget’s sensitive 
and ancestor_sensitive 
attributes 


Null 

Depth of the parent window 
Not supported 

True 


The parent screen 
Null 





foreground 
highlight 


highlight_pixmap 


user_data 


direction_r_to_| 


font 


grab_key_syms 


grab_merge_ 
translations 


help_callback 


DWT$C_NFOREGROUND 
DWT$C_NHIGHLIGHT 
DWT$C_NHIGHLIGHT_PIXMAP 
DWT$C_NUSER_DATA 
DWT$C_NDIRECTION_R_TO_L 
DWT$C_NFONT 
DWT$C_NGRAB_KEY_SYMS 


DWT$C_NGRAB_MERGE_ 
TRANSLATIONS 


DWT$C_NHELP_CALLBACK 


uns longword 
uns longword 
uns longword 
uns longword 
uns byte 

uns longword 
uns longword 
uns longword 


uns longword 


Default foreground color 
Default foreground color 

Null 

Null 

False 

Not supported 

Tab key 

See DIALOG BOX CREATE. 


Not supported 
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Table A-25 (Cont.) Separator Attributes 


Attribute 
Label Attributes 


VAX Name 


VAX Data Type 


A.25 Separator 


Default 





label_type DWT$C_NLABEL_TYPE uns byte DWT$C_CSTRING 

label DWT$C_NLABEL uns longword Widget name 

margin_width DWT$C_NMARGIN_WIDTH uns word 2 pixels for text; 0 pixels for — 
pixmap 

margin_height DWT$C_NMARGIN_HEIGHT uns word 2 pixels for text; 0 pixels for 
pixmap 

alignment DWT$C_NALIGNMENT uns byte Center alignment 

pixmap DWT$C_NPIXMAP uns longword Null 

margin_left DWT$C_NMARGIN_LEFT uns word 0 pixels 

margin_right DWT$C_NMARGIN_RIGHT uns word 0 pixels 

margin_top DWT$C_NMARGIN_TOP uns word 0 pixels 

margin_bottom DWT$C_NMARGIN_BOTTOM uns word 0 pixels 

conform_to_text DWT$C_NCONFORM_TO_TEXT uns byte True if width and height 
are zero; false if width and 
height are not zero 

Widget-Specific Attributes 

orientation DWT$C_NORIENTATION uns byte DWT$C_ORIENTATION_ 
HORIZONTAL 

S Text 


See Table A—26 for a summary of simple text widget attributes. 


Table A-26 S Text Attributes 


Attribute 


Core Widget Attributes 


xX 


width 


VAX Name 


DWT$C_NX 
DWT$C_NY 


DWT$C_NWIDTH 


VAX Data Type 


longword 
longword 


uns word 


Default 


Determined by the geometry 
manager 


Determined by the geometry 
manager 


As large as necessary to 
display the rows and cols 
with the given margin_width 
and margin_height 
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A.26 S Text 


Table A-26 (Cont.) S Text Attributes 


Attribute 


Core Widget Attributes 


height 


border_width 

border 
border_pixmap 
background 
background_pixmap 
colormap 

sensitive 
ancestor_sensitive 


accelerators 
depth 
translations 


mapped_when_ 
managed 


screen 
destroy_callback 


VAX Name 


DWT$C_NHEIGHT 


DWT$C_NBORDER_WIDTH 
DWT$C_NBORDER 
DWT$C_NBORDER_PIXMAP 
DWT$C_NBACKGROUND 
DWT$C_NBACKGROUND_PIXMAP 
DWT$C_NCOLORMAP 


. DWT$C_NSENSITIVE 


DWT$C_NANCESTOR_SENSITIVE 


DWT$C_NACCELERATORS 
DWT$C_NDEPTH 
DWT$C_NTRANSLATIONS 


DWT$C_NMAPPED_WHEN_ 
MANAGED 


DWT$C_NSCREEN 
DWT$C_NDESTROY_CALLBACK 


Widget-Specific Attributes 


margin_width 
margin_height 
cols 

rows 
top_position 
word_wrap 
scroll_vertical 
resize_height 
resize_width 
value 
editable 
max_length 
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DWT$C_NMARGIN_WIDTH 
DWT$C_NMARGIN_HEIGHT 
DWT$C_NCOLS 
DWT$C_NROWS 
DWT$C_NTOP_POSITION 
DWT$C_NWORD_WRAP 
DWT$C_NSCROLL_VERTICAL 
DWT$C_NRESIZE_HEIGHT 
DWT$C_NRESIZE_WIDTH 
DWT$C_NVALUE 
DWT$C_NEDITABLE 
DWT$C_NMAX_LENGTH 


VAX Data Type 


uns word 


uns word 
uns longword 
uns longword 
uns longword 
uns longword 
uns longword 
uns byte 
uns byte 


uns longword 
uns longword 
uns longword 
uns byte 


uns longword 
uns longword 


uns word 
uns word 
uns longword 
uns longword 
uns longword 
uns byte 

uns byte 

uns byte 

uns byte 
char string 
uns byte 

uns longword 


Default 


As large as necessary to 
display the rows and cols 
with the given margin_width 
and margin_height 


1 pixel 

Default foreground color 
Null 

Default background color 
Null 

Default color map 

True 


The bitwise AND of the 
parent widget’s sensitive 
and ancestor_sensitive 
attributes 


Null 
Depth of the parent window 
Null 
True 


The parent screen 
Null 


2 pixels 

2 pixels 

20 characters 
1 character 
Zero 

False 

False 

True 

True 

null string 


True 
931-1 
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Table A-26 (Cont.) S Text Attributes 


Attribute 


VAX Name 


Widget-Specific Attributes 


focus_callback 
help_callback 
lost_focus_callback 


value_changed_ 
callback 


insertion_point_visible 


auto_show_insert_ 
point 


insertion_position 
foreground 

font 

blink_rate 
scroll_left_side 
half_border 
pending_delete 


DWT$C_NFOCUS_CALLBACK 
DWT$C_NHELP_CALLBACK 


DWT$C_NLOST_FOCUS __ 
CALLBACK 


DWT$C_NVALUE_CHANGED_ 
CALLBACK 


DWT$C_NINSERTION_POINT_ 
VISIBLE 


DWT$C_NAUTO_SHOW_INSERT_ 
POINT 


DWT$C_NINSERTION_POSITION 
DWT$C_NFOREGROUND 
DWT$C_NFONT 
DWT$C_NBLINK_RATE 
DWT$C_NSCROLL_LEFT_SIDE 
DWT$C_NHALF_BORDER 
DWT$C_NPENDING_DELETE 


VAX Data Type 


uns longword 
uns longword 
uns longword 


uns longword 
uns byte 
uns byte 


uns longword 
uns longword 
uns longword 
uns longword 
uns byte 
uns byte 
uns byte 


A.26 S Text 


Default 


Null 
Null 
Null 


Null 
True 
True 


Zero 

Default foreground color 
Current server font list 
500 milliseconds 

False 

True 

True 





Toggle Button 


See Table A-27 for a summary of toggle button widget attributes. 


Table A-27 Toggle Button Attributes 


Attribute 


Core Widget Attributes 


X 


width 


height 


border_width 
border 


VAX Name 


DWT$C_NX 
DWT$C_NY 


DWT$C_NWIDTH 
DWT$C_NHEIGHT 


DWT$C_NBORDER_WIDTH 
DWT$C_NBORDER 


VAX Data Type 


longword 
longword 


uns word 


uns word 


uns word 
uns longword 


Default 


Determined by the geometry 
manager 


Determined by the geometry 
manager 


Width of the label or pixmap, 
plus two times margin_ 
width 


Height of the label or 
pixmap, plus two times 
margin_height 


0 pixels 
Default foreground color 
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A.27 Toggle Button 


Table A—27 (Cont.) Toggle Button Attributes 


Attribute VAX Name VAX Data Type Default 

Core Widget Attributes 

border_pixmap DWT$C_NBORDER_PIXMAP uns longword Null 

background DWT$C_NBACKGROUND uns longword Default background color 
background_pixmap DWT$C_NBACKGROUND_PIXMAP _ uns longword Null 

colormap DWT$C_NCOLORMAP uns longword Default color map 
sensitive DWT$C_NSENSITIVE uns byte True 

ancestor_sensitive DWT$C_NANCESTOR_SENSITIVE _ uns byte The bitwise AND of the 


accelerators 
depth 
translations 


mapped_when_ 


managed 
screen 


destroy_callback 


DWT$C_NACCELERATORS 
DWT$C_NDEPTH 
DWT$C_NTRANSLATIONS 


DWT$C_NMAPPED_WHEN_ 
MANAGED 


DWT$C_NSCREEN 
DWT$C_NDESTROY_CALLBACK 


Common Widget Attributes 


foreground 
highlight 


highlight_pixmap 


user_data 


direction_r_to_| 


font 


grab_key_syms 


grab_merge_ 
translations 


‘help_callback 


DWT$C_NFOREGROUND 
DWT$C_NHIGHLIGHT 
DWT$C_NHIGHLIGHT_PIXMAP 
DWT$C_NUSER_DATA 
DWT$C_NDIRECTION_R_TO_L 
DWT$C_NFONT 
DWT$C_NGRAB_KEY_SYMS 


DWT$C_NGRAB_MERGE_ 
TRANSLATIONS 


DWT$C_NHELP_CALLBACK 


uns longword 
uns longword 
uns longword 
uns byte 


uns longword 
uns longword 


uns longword 
uns longword 
uns longword 
uns longword 
uns byte 

uns. longword 
uns longword 
uns longword 


uns longword 


parent widget’s sensitive 
and ancestor_sensitive 
attributes 


Null 
Depth of the parent window 
Null 
True 


The parent screen 
Null 


Default foreground color 
Default foreground color 

Null 

Null 

False 

XUI Toolkit font 

Tab key 

See DIALOG BOX CREATE. 


Null 





Label Attributes 





label_type 
label 
margin_width 


margin_height 


DWT$C_NLABEL_TYPE 
DWT$C_NLABEL 
DWT$C_NMARGIN_WIDTH 


DWT$C_NMARGIN_HEIGHT 


uns byte 
uns longword 
uns word 


uns word 


DWT$C_CSTRING 
Widget name 


2 pixels for text; 0 pixels for 
pixmap 


2 pixels for text; 0 pixels for 
pixmap ; 
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Table A-27 (Cont.) Toggle Button Attributes 


Attribute 


Label Attributes 


VAX Name 


VAX Data Type 


A.27 Toggle Button 


Default 





alignment DWT$C_NALIGNMENT uns byte Center alignment 

pixmap DWT$C_NPIXMAP uns longword Null 

margin_left DWT$C_NMARGIN_LEFT uns word 0 pixels 

margin_right DWT$C_NMARGIN_RIGHT uns word 0 pixels 

margin_top DWT$C_NMARGIN_TOP uns word 0 pixels 

margin_bottom DWT$C_NMARGIN_BOTTOM uns word 0 pixels 

conform_to_text DWT$C_NCONFORM_TO_TEXT uns byte True if width and height 
are zero; false if width and 
height are not zero 

Widget-Specific Attributes 

shape DWT$C_NSHAPE uns byte DWT$C_RECTANGULAR 

visible_when_off DWT$C_NVISIBLE_WHEN_OFF uns byte True 


spacing 
pixmap_on 
pixmap_off 


arm_callback 
disarm_cailback 


value_changed_ 
callback 


indicator 


accelerator_text 
button_accelerator | 


DWT$C_NSPACING 
DWT$C_NPIXMAP_ON 
DWT$C_NPIXMAP_OFF 

value DWT$C_NVALUE 
DWT$C_NARM_CALLBACK 
DWT$C_NDISARM_CALLBACK 


DWT$C_NVALUE_CHANGED _ 
CALLBACK 


DWT$C_NINDICATOR 


DWT$C_NACCELERATOR_TEXT 
DWT$C_NBUTTON_ 


uns longword 
uns longword 
uns longword 
uns byte 

uns longword 
uns longword 
uns longword 


uns byte 


uns longword 
char string 


ACCELERATOR 


4 pixels 
Null 
Null 
False 
Null 
Null 
Null 


True when label is text; false 
when label is pixmap 


Null 
Null 





Window 


See Table A-28 for a summary of window widget attributes. 
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A.28 Window 


Table A-28 Window Attributes 








Attribute VAX Name VAX Data Type Default 

Core Widget Attributes 

x DWT$C_NX longword Determined by the geometry 
manager 

y DWT$C_NY longword Determined by the geometry 
manager 

width DWT$C_NWIDTH uns word 0 pixels 

height DWT$C_NHEIGHT uns word 0 pixels 

border_width DWT$C_NBORDER_WIDTH uns word 1 pixel 

border DWT$C_NBORDER uns longword Default foreground color 

border_pixmap DWT$C_NBORDER_PIXMAP uns longword Null 

background — DWT$C_NBACKGROUND uns longword Default background color 

background_pixmap DWT$C_NBACKGROUND_PIXMAP _ uns longword Null 

colormap DWT$C_NCOLORMAP uns longword Default color map 

sensitive DWT$C_NSENSITIVE uns byte True 

ancestor_sensitive DWT$C_NANCESTOR_SENSITIVE uns byte The bitwise AND of the 


accelerators 
depth 
translations 


mapped_when_ 
managed 


screen 
destroy_callback 


DWT$C_NACCELERATORS 
DWT$C_NDEPTH 
DWT$C_NTRANSLATIONS 


DWT$C_NMAPPED_WHEN_ 
MANAGED 


DWT$C_NSCREEN 
DWT$C_NDESTROY_CALLBACK 


Common Widget Attributes 


foreground 
highlight 
highlight_pixmap 
user_data 
direction_r_to_| 
font 
grab_key_syms 


grab_merge_ 
translations 


help_callback 


DWT$C_NFOREGROUND 
DWT$C_NHIGHLIGHT 
DWT$C_NHIGHLIGHT_PIXMAP 
DWT$C_NUSER_DATA 
DWT$C_NDIRECTION_R_TO_L 
DWT$C_NFONT 
DWT$C_NGRAB_KEY_SYMS 


DWT$C_NGRAB_MERGE_ 
TRANSLATIONS 


DWT$C_NHELP_CALLBACK 


Widget-Specific Attribute 


expose_callback 
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DWT$C_NEXPOSE_CALLBACK 


uns longword 
uns longword 
uns longword 
uns byte 


uns longword 
uns longword 


uns longword 
uns longword 
uns longword 
uns longword 
uns byte 

uns longword 
uns longword 
uns longword 


uns longword 


uns longword 


parent widget’s sensitive 
and ancestor_sensitive 
attributes 


Null 
Depth of the parent window 
Null 
True 


The parent screen 
Null 


Default foreground color 
Default foreground color 

Null 

Null 

False 

Not supported 

Tab key 

See DIALOG BOX CREATE. 


Not supported 


Null 
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A.28 Window 





Work Box 


See Table A—29 for a summary of work box widget attributes. 


Table A-29 Work Box Attributes 


Attribute 


VAX Name 


VAX Data Type 


Default 





Core Widget Attributes 


X 


y 


width 

height 

border_width 

border 
border_pixmap 
background 
background_pixmap 
colormap 

sensitive 
ancestor_sensitive 


accelerators 
depth 
translations 


mapped_when_ 
managed 


screen 
destroy_callback 


DWT$C_NX 
DWTS$C_NY 


DWT$C_NWIDTH 
DWT$C_NHEIGHT 
DWT$C_NBORDER_WIDTH 
DWT$C_NBORDER 
DWT$C_NBORDER_PIXMAP 
DWT$C_NBACKGROUND 
DWT$C_NBACKGROUND_PIXMAP 
DWT$C_NCOLORMAP 
DWT$C_NSENSITIVE 
DWT$C_NANCESTOR_SENSITIVE 


DWT$C_NACCELERATORS 
DWT$C_NDEPTH 
DWT$C_NTRANSLATIONS 


DWT$C_NMAPPED_WHEN_ 
MANAGED 


DWT$C_NSCREEN 
DWT$C_NDESTROY_CALLBACK 


longword 
longword 


uns word 
uns word 
uns word 
uns longword 
uns longword 
uns longword 
uns longword 
uns longword 


-uns byte 


uns byte 


uns longword 
uns longword 
uns longword 
uns byte 


uns longword 
uns longword 


Determined by the geometry 
manager 


Determined by the geometry 
manager 


5 pixels 

5 pixels 

1 pixel 

Default foreground color 
Null 

Default background color 
Null 

Default color map 

True 


The bitwise AND of the 
parent widget’s sensitive 
and ancestor_sensitive 
attributes 


Null 
Depth of the parent window 
Null 
True 


The parent screen 
Null 
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A.29 Work Box 


Table A-29 (Cont.) Work Box Attributes 


Attribute 


VAX Name 


VAX Data Type 


Default 





Dialog Box Pop-Up Attributes 





foreground 
highlight 
highlight_pixmap 
user_data 
direction_r_to_| 
font 
grab_key_syms 


grab_merge_ 
translations 


help_callback 
units 

title 

style 
map_callback 
unmap_callback 
focus_callback 


text_merge_ 
translations 


margin_width 
margin_height 
default_position 
child_overlap 
resize 
take_focus 


no_resize 
auto_unmanage 
default_button 
cancel_button 


DWT$C_NFOREGROUND 
DWT$C_NHIGHLIGHT 
DWT$C_NHIGHLIGHT_PIXMAP 
DWT$C_NUSER_DATA 
DWT$C_NDIRECTION_R_TO_L 
DWT$C_NFONT 
DWT$C_NGRAB_KEY_SYMS 


DWT$C_NGRAB_MERGE_ 
TRANSLATIONS 


DWT$C_NHELP_CALLBACK 
DWT$C_NUNITS 
DWT$C_NTITLE 
DWT$C_NSTYLE 
DWT$C_NMAP_ CALLBACK 
DWT$C_NUNMAP_CALLBACK 
DWT$C_NFOCUS_CALLBACK 


DWT$C_NTEXT_MERGE_ 
TRANSLATIONS 


DWT$C_NMARGIN_WIDTH 
DWT$C_NMARGIN_HEIGHT 
DWT$C_NDEFAULT_POSITION 
DWT$C_NCHILD_OVERLAP 
DWT$C_NRESIZE 
DWT$C_NTAKE_FOCUS 


DWT$C_NNO_RESIZE 
DWT$C_NAUTO_UNMANAGE 
DWT$C_NDEFAULT_BUTTON 
DWT$C_NCANCEL_BUTTON 


Widget-Specific Attributes 


label 
cancel_label 
cancel_callback 


DWT$C_NLABEL 
DWT$C_NCANCEL_LABEL 


DWT$C_NCANCEL_CALLBACK 


uns longword 
uns longword 
uns longword 
uns longword 
uns byte 

uns longword 
uns longword 
uns longword 


uns longword 
uns byte 

uns longword 
uns byte 

uns longword 
uns longword 
uns longword 
uns longword 


uns word 
uns word 
uns byte 
uns byte 
uns byte 
uns byte 


uns byte 
uns byte 
uns longword 
uns longword 


uns longword 
uns longword 
uns longword 


Default foreground color 
Default foreground color 
Null 

Null 

Not supported 

XUI Toolkit font 

Tab key 

See DIALOG BOX CREATE. 


Null 

Not supported 
Widget name 
DWT$C_MODAL 
Null 

Null 

Null 

Not supported 


12 pixels 

10 pixels 

False 

Not supported 
DWT$C_SHRINK_WRAP 


True for modal dialog box; 
false for a modeless dialog 
box 


True 
True 
Not supported 
Not supported 


Widget name 
“Cancel” 
Null 
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Summary of Widget Attributes (C Binding) 


This appendix contains tables listing all attributes for each widget. The 
attributes are listed according to the widget class hierarchy beginning 
with the superclass widget. Any widget-specific exceptions to the inherited 
defaults are listed in the defaults column. 


Each table contains the following information: 


¢ Attribute name (same for VAX and C binding) 


¢ C name for the attribute 


¢ C data type 
¢ Default value 


Attached Dialog Box 


See Table B—1 for a summary of attached dialog box widget attributes. 


Table B—1 Attached Dialog Box Attributes 


Attribute 


Core Widget Attributes 


X 


y 


width 

height 

border_width 

border 
border_pixmap 
background 
background_pixmap 
colormap 

sensitive 
ancestor_sensitive 


accelerators 


C Name 


DwtNx 
DwtNy 


DwtNwidth 

DwtNheight 
DwtNborderWidth 
DwtNborder 
DwtNborderPixmap 
DwtNbackground 
DwtNbackgroundPixmap 
DwtNcolormap 
DwtNsensitive 
DwtNancestorSensitive 


DwtNaccelerators 


C Data Type 


Position 
Position 


Dimension 
Dimension 
Dimension 
Pixel 
Pixmap 
Pixel 
Pixmap 
Colormap 
Boolean 
Boolean 


XtTranslations 


Default 


Determined by the geometry 
manager 


Determined by the geometry 
manager 


5 pixels 

5 pixels 

1 pixel 

Default foreground color 
Null 

Default background color 
Null 

Default color map 

True 


The bitwise AND of the 
parent widget’s sensitive 
and ancestor_sensitive 
attributes 


Null 
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B.1 Attached Dialog Box 


Table B—1 (Cont.) Attached Dialog Box Attributes 





Attribute C Name C Data Type Default 

Core Widget Attributes 

depth DwtNdepth int Depth of the parent window 
translations DwtNtranslations XtTranslations Null 

mapped_when_ DwtNmappedWhenManaged Boolean True 

managed 

screen DwiNscreen Screen * The parent screen 


destroy_callback 


Dialog Box Attributes 


foreground 
highlight 
highlight_pixmap 
user_data 
direction_r_to_| 
font 
help_callback 
units 

style 
focus_callback 


text_merge_ 
translations 


margin_width 
margin_height 
default_position 
child_overlap 
resize 
grab_key_syms 


grab_merge_ 
translations 


DwtNdestroyCaliback 


DwtNforeground 
DwtNhighlight 
DwtNhighlightPixmap 
DwtNuserData 
DwtNdirectionRToL 
DwtNfont 
DwiNhelpCallback 
DwtNunits 

DwtNstyle 
DwtNfocusCallback 
DwiNtextMerge Translations 


DwiNmarginWidth 
DwtNmarginHeight 
DwitNdefaultPosition 
DwtNchildOverlap 
DwtNresize 
DwtNgrabKeySyms 


DwtNgrabMergeTranslations 


DwtCallbackPtr 


Pixel 

Pixel 

Pixmap 
Opaque * 
Boolean 
DwtFontList 
DwtCallbackPir 
unsigned char 
unsigned char 
DwtCallbackPtr 
XtTranslations 


Dimension 
Dimension 
Boolean 
Boolean 
unsigned char 
KeySym 


XtTranslations 


Null 


Default foreground color 
Default foreground color 
Null 

Null 

False 

XU] Toolkit font 

Null 

DwtFontUnits 
DwtWorkarea 

Null 

Null 


1 pixel 

1 pixel 

False 

True 
DwtResizeGrowOnly 


The default array contains 
the Tab key symbol. 


See DIALOG BOX CREATE 
for the default syntax. 
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Summary of Widget Attributes (C Binding) 
B.1 Attached Dialog Box 








Attribute C Name C Data Type Default 
Widget-Specific Attributes 

default_horizontal_ DwiNdefaultHorizontalOffset int 0 pixels 
offset 

default_vertical_offset | DwtNdefaultVerticalOffset int 0 pixels 
rubber_positioning DwtNrubberPositioning Boolean False 
fraction_base DwtNfractionBase int 100 








Attached Dialog Box Popup 
See Table B—2 for a summary of attached dialog box pop-up widget 


Table B-2 Attached Dialog Box Pop-Up Attributes 


attributes. 








Attribute C Name C Data Type Default 

Core Widget Attributes 

X DwtNx Position Determined by the geometry 
manager 

y DwiNy Position Determined by the geometry 
manager 

width DwiNwidth Dimension 0 pixels 

height DwtNheight Dimension 0 pixels 

border_width DwtNborderWidth Dimension 1 pixel 

border DwitNborder Pixel Default foreground color 

border_pixmap DwtNborderPixmap Pixmap Null 

background DwtNbackground Pixel Default background color 

background_pixmap DwtNbackgroundPixmap Pixmap Null 

colormap DwtNcolormap Colormap Default color map 

sensitive DwtNsensitive Boolean True 

ancestor_sensitive DwtNancestorSensitive Boolean The bitwise AND of the 
parent widget’s sensitive 
and ancestor_sensitive 
attributes 

accelerators DwtNaccelerators XtTranslations Null 

depth DwtNdepth int Depth of the parent window 
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Table B-2 (Cont.) Attached Dialog Box Pop-Up Attributes 





Attribute C Name C Data Type Default 

Core Widget Attributes 

translations DwiNtranslations XtTranslations Null 
mapped_when_ DwtNmappedWhenManaged Boolean True 

managed 

screen DwtNscreen Screen * The parent screen 


destroy_cailback 


DwitNdestroyCallback 


Dialog Box Pop-Up Attributes 


foreground 
highlight 
highlight_pixmap 
user_data 
direction_r_to_| 
font 
help_callback 
units 

style 
focus_callback 


text_merge_ 
translations 


margin_width 
margin_height 
default_position 
child_overlap 
resize 

no_resize 

title 
map_callback 
unmap_callback 
take_focus 


auto_unmanage 
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DwtNforeground 
DwtNhighlight 
DwtNhighlightPixmap 
DwtNuserData 
DwiNdirectionRToL 
DwtNfont 
DwtNhelpCallback 
DwtNunits 

DwtNstyle 
DwtNfocusCallback 
DwtNtextMergeTranslations 


DwitNmarginWidth 
DwtNmarginHeight 
DwtNdefaultPosition 
DwtNchildOverlap 
DwtNresize 
DwtNnoResize 
DwtNtitle 
DwtNmapCallback 
DwtNunmapCallback 
DwtNtakeFocus 


DwtNautoUnmanage 


DwtCailbackPtr 


Pixel 

Pixel 

Pixmap 
Opaque * 
Boolean 
DwtFontList 
DwtCailbackPtr 
unsigned char 
unsigned char 
DwtCallbackPtr 
XtTranslations 


Dimension 
Dimension 
Boolean 
Boolean 
unsigned char 
Boolean 
DwtCompString 
DwtCallbackPtr 
DwiCallbackPtr 
Boolean 


Boolean 


Null 


Default foreground color 
Default foreground color 
Null 

Null 

False 

XUI Toolkit font 

Null 

DwitFontUnits 
DwtDwtModeless 

Null 

Null 


3 pixels 

3 pixels 

False 

True 
DwtResizeGrowOnly 
True 

Widget name 

Null 

Null 


True for modal dialog box; 
false for modeless dialog 
box 


True 
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B.2 Attached Dialog Box Popup 


Table B-2 (Cont.) Attached Dialog Box Pop-Up Attributes 


Attribute C Name 


Dialog Box Pop-Up Attributes 


default_button DwtNdefaultButton 
cancel_button DwtNeancelButton 
grab_key_syms DwiNgrabKeySyms 
grab_merge_ DwtNgrabMerge Translations 


translations 


Widget-Specific Attributes 


default_horizontal_ DwitNdefaultHorizontalOffset 
offset 

default_vertical_offset © DwtNdefaultVerticalOffset 
rubber_positioning DwitNrubberPositioning 
fraction_base DwtNfractionBase 


C Data Type 


Widget 
Widget 
KeySym 


XtTranslations 


int 


int 
Boolean 
int 


Default 


Null 
Null 


The default array contains 
the Tab key symbol. 


See DIALOG BOX CREATE 
for the default syntax. 


0 pixels 


0 pixels 
False 
100 





Caution Box 


See Table B—3 for a summary of caution box widget attributes. 


Table B-3 Caution Box Attributes 
Attribute C Name 


Core Widget Attributes 


x DwtNx 

y DwiNy 

width DwtNwidth 

height DwtNheight 
border_width DwtNborderWidth 
border DwtNborder 
border_pixmap DwtNborderPixmap 
background DwtNbackground 
background_pixmap DwtNbackgroundPixmap 
colormap DwitNcolormap 
sensitive DwtNsensitive 


C Data Type 


Position 
Position 


Dimension 
Dimension 
Dimension 
Pixel 
Pixmap 
Pixel 
Pixmap 
Colormap 
Boolean 


Default 


Determined by the geometry 
manager 


Determined by the geometry 
manager 


5 pixels 

5 pixels 

1 pixel 

Default foreground color 
Null 

Default background color 
Null 

Default color map 

True 
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B.3 Caution Box 


Table B-3 (Cont.) Caution Box Attributes 


Attribute 


Core Widget Attributes 


ancestor_sensitive 


accelerators 
depth 
translations 


mapped_when_ 
managed 


screen 
destroy_callback 


C Name 


DwitNancestorSensitive 


DwtNaccelerators 
DwtNdepth 

DwtNtranslations 
DwtNmappedWhenManaged 


DwtNscreen 
DwtNdestroyCallback 


Dialog Box Pop-Up Attributes 


foreground 
highlight 
highlight_pixmap 
user_data 
direction_r_to_| 
font 
help_callback 
units 

title 

style 
map_callback 
unmap_callback 
focus_callback 


text_merge_ 
translations 


margin_width 
margin_height 
default_position 
child_overlap 
resize 
take_focus 


DwtNforeground 
DwitNhighlight 
DwtNhighlightPixmap 
DwtNuserData 
DwtNdirectionRToL 
DwtNfont 
DwtNhelpCallback 
DwtNunits 

DwiNtitle 

DwtNstyle 
DwtNmapCallback 
DwtNunmapCallback 
DwtNfocusCallback 
DwtNtextMergeTranslations 


DwtNmarginWidth 
DwtNmarginHeight 
DwtNdefaultPosition 
DwtNchildOverlap 
DwtNresize 
DwtNtakeFocus 


C Data Type 


Boolean 


XtTranslations 
int 
XtTranslations 
Boolean 


Screen * 
DwtCallbackPtr 


Pixel 

Pixel 

Pixmap 
Opaque * 
Boolean 
DwtFontList 
DwtCallbackPtr 
unsigned char 
DwtCompString 
unsigned char 
DwiCallbackPtr 
DwtCallbackPtr 
DwtCallbackPtr 
XtTranslations 


Dimension 
Dimension 
Boolean 
Boolean 
unsigned char 
Boolean 


Default 


The bitwise AND of the 
parent widget’s sensitive 
and ancestor_sensitive 
attributes 


Null 
Depth of the parent window 
Null 
True 


The parent screen 
Null 


Default foreground color 
Default foreground color 
Null 

Null 

Not supported 

XUI Toolkit font 

Null 

Not supported 

Widget name 

DwtModal 

Null 

Null 

Null 

Not supported 


12 pixels 

10 pixels 

False 

Not supported 
DwtResizeShrinkWrap 


True for modal dialog box; 
false for modeless dialog 
box 
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Table B-3 (Cont.) Caution Box Attributes 
Attribute C Name C Data Type Default 


Dialog Box Pop-Up Attributes 


no_resize DwtNnoResize Boolean True 
auto_unmanage DwtNautoUnmanage Boolean True 
default_button DwtNdefaultButton Widget Not supported 
cancel_button DwtNeancelButton Widget Not supported 


Widget-Specific Attributes 


label DwtNlabel DwtCompString Widget name 
yes_label DwtNyesLabel DwtCompString “Yes” 
no_label DwitNnoLabel DwtCompString “No” 
cancel_label DwtNcancelLabel DwtCompSiring “Cancel” 
default_push_button DwtNdefaultPushButton unsigned char Yes button 
yes_callback DwtNyesCallback. DwtCalibackPtr Null 
no_callback DwtNnoCalliback DwtCallbackPtr Null 


cancel_callback DwtNeancelCallback DwtCallbackPtr Null 





Command Window 


See Table B-4 for a summary of command window widget attributes. 


Table B—-4 Command Window Attributes 
Attribute C Name C Data Type Default 


Core Widget Aitributes 


X DwtNx Position Determined by the geometry 
manager 

y DwtNy Position Determined by the geometry 
manager 

width DwtNwidth Dimension 0 pixels 

height DwtNheight Dimension 0 pixels 

border_width DwtNborderWidth Dimension 1 pixel 

border DwtNborder Pixel Default foreground color 

border_pixmap DwtNborderPixmap Pixmap Null 

background DwtNbackground Pixel ~ Default background color 

background_pixmap DwtNbackgroundPixmap Pixmap Null 

colormap DwtNcolormap Colormap Default color map 
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Table B—4 (Cont.) Command Window Attributes 


Attribute 


Core Widget Attributes 


sensitive 


ancestor_sensitive 


accelerators 
depth 
translations 


mapped_when_ 
managed 


screen 
destroy_cailback 


C Name 


DwiNsensitive 
DwtNancestorSensitive 


DwtNaccelerators 
DwtNdepth 

DwtNtranslations 
DwtNmappedWhenManaged 


DwtNscreen 
DwtNdesitroyCallback 


Dialog Box Pop-Up Attributes 


foreground 
highlight 
highlight_pixmap 
user_data 
direction_r_to_| 
font 
help_catlback 
units 

title 

style 
map_callback 
unmap_callback 
focus_callback 


text_merge_ 
translations 


margin_width 
margin_height 
default_position 
child_overlap 
resize 
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DwtNforeground 
DwtNhighlight 
DwtNhighlightPixmap 
DwiNuserData 
DwiNdirectionRToL 
DwtNfont 
DwtNhelpCallback 
DwtNunits 

DwiNtitle 

DwtNstyle 
DwtNmapCallback 
DwitNunmapCallback 
DwtNfocusCallback 
DwitNtextMerge Translations 


DwtNmarginWidth 
DwtNmarginHeight 
DwtNdefaultPosition 
DwtNchildOverlap 
DwitNresize 


C Data Type 


Boolean 
Boolean 


XtTranslations 
int 
XtTranslations 
Boolean 


Screen * 
DwtCallbackPtr 


Pixel 

Pixel 

Pixmap 
Opaque * 
Boolean 
DwtFontList 
DwtCallbackPtr 
unsigned char 
DwtCompString 
unsigned char 
DwiCallbackPtr 
DwtCallbackPtr 
DwtCallbackPtr 
XtTranslations 


Dimension 
Dimension 
Boolean 
Boolean 
unsigned char 


Default 


True 


The bitwise AND of the 
parent widget’s sensitive 
and ancestor_sensitive 
attributes 


Null 
Depth of the parent window 
Null 
True 


The parent screen 
Null 


Default foreground color 
Default foreground color 
Null 

Null 

Not supported 

XUI Toolkit font 

Null 

Not supported 

Widget name 

DwtModal 

Null 

Null 

Null 

Not supported 


12 pixels 

10 pixels 
True 

Not supported 
Not supported 
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B.4 Command Window 


Table B—4 (Cont.) Command Window Attributes 





Attribute C Name C Data Type Default 
Widget-Specific Attributes 

value DwiNvalue char * Null 
prompt DwtNprompt DwtCompSiring > 
lines DwiNlines int 2 lines 
history DwiNhistory char * Null string 
command_entered_ DwtNcommandEnteredCallback DwtCallbackPtr Null 
callback 

value_changed_ DwtNvalueChangedCaillback DwtCallbackPtr Null 
callback 

t_translation DwtNtTranslation XtTranslations Null 





Dialog Box 


See Table B—5 for a summary of dialog box widget attributes. 


Table B—5 Dialog Box Attributes 


Attribute | 


Core Widget Attributes 


< 


< 


width 

height 

border_width 

border 
border_pixmap 
background 
background_pixmap 
colormap 

sensitive 
ancestor_sensitive 


accelerators 


C Name 


DwtNx 
DwtNy 


DwtNwidth 

DwtNheight 
DwtNborderWidth 
DwtNborder 
DwtNborderPixmap 
DwtNbackground 
DwtNbackgroundPixmap 
DwiNcolormap 
DwiNsensitive 
DwtNancestorSensitive 


DwtNaccelerators 


C Data Type 


Position 
Position 


Dimension 
Dimension 
Dimension 
Pixel 
Pixmap 
Pixel 
Pixmap 
Colormap 
Boolean 
Boolean 


XtTranslations 


Default 


Determined by the geometry 
manager 


Determined by the geometry 
manager 


5 pixels 

5 pixels 

1 pixel 

Default foreground color 
Null 

Default background color 
Null 

Default color map 

True 


The bitwise AND of the 
parent widget’s sensitive 
and ancestor_sensitive 
attributes 


Null 
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B.5 Dialog Box 


Table B—5 (Cont.) Dialog Box Attributes 








Attribute C Name C Data Type Default 

Core Widget Attributes 

depth DwtNdepth int Depth of the parent window 
translations DwtNtranslations XtTranslations Null 

mapped_when_ DwtNmappedWhenManaged Boolean True 

managed 

screen DwtNscreen Screen * The parent screen 


destroy_callback 


DwtNdestroyCallback 


DwtCallbackPtr 


Null 





Widget-Specific Attributes 





foreground DwtNforeground Pixel Default foreground color 

highlight DwtNhighlight Pixel Default foreground color 

highlight_pixmap DwtNhighlightPixmap Pixmap Null 

user_data DwiNuserData Opaque * Null 

direction_r_to_| DwtNdirectionRToL Boolean False 

font DwtNfont DwtFontList XUI Toolkit font 

heip_callback DwtNhelpCallback DwtCallbackPtr Null 

units DwtNunits unsigned char DwtFontUnits 

style DwitNstyle unsigned char DwitWorkarea 

focus_callback DwtNfocusCallback DwtCallbackPtr Null 

text_merge_ DwtNtextMergeTranslations XtTranslations Null 

translations 

margin_width DwtNmarginWidth Dimension 1 pixel 

margin_height DwtNmarginHeight Dimension 1 pixel 

default_position DwtNdefaultPosition Boolean False 

child_overlap DwtNchildOverlap Boolean True 

resize DwiNresize unsigned char DwtResizeGrowOnly 

grab_key_syms DwitNgrabKeySyms KeySym The default array contains 
the Tab key symbol. 

grab_merge_ DwtNgrabMergeTransiations XtTranslations See DIALOG BOX CREATE 

translations for the default syntax. 

Dialog Box Popup 
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Table B-6 Dialog Box Pop-Up Attributes 


Attribute 


Core Widget Attributes 


X 


y 


width 

height 

border_width 

border 
border_pixmap 
background 
background_pixmap 
colormap 

sensitive 
ancestor_sensitive 


accelerators 
depth 
translations 


mapped_when_ 
managed 


screen 
destroy_callback 


C Name 


DwtNx 
DwtNy 


DwitNwidth 

DwtNheight 
DwtNborderWidth 
DwtNborder 
DwtNborderPixmap 
DwtNbackground 
DwiNbackgroundPixmap 
DwtNcolormap 
DwitNsensitive 
DwiNancestorSensitive 


DwtNaccelerators 
DwtNdepth 

DwiNtranslations 
DwtNmappedWhenManaged 


DwtNscreen 
DwtNdestroyCallback 


Widget-Specific Attributes 


foreground 
highlight 
highlight_pixmap 
user_data 
direction_r_to_| 
font . 
help_callback 
units 

style 
focus_callback 


DwtNforeground 
DwtNhighlight 
DwtNhighlightPixmap 
DwtNuserData 
DwtNdirectionRToL 
DwiNfont 
DwtNhelpCallback 
DwtNunits 

DwtNstyle 
DwtNfocusCallback 


C Data Type 


Position 
Position 


Dimension 
Dimension 
Dimension 
Pixel 
Pixmap 
Pixel 
Pixmap 
Colormap 
Boolean 
Boolean 


| XtTranslations 


int 
XtTranslations 
Boolean 


Screen * 
DwtCallbackPtr 


Pixel 

Pixel 

Pixmap 
Opaque * 
Boolean 
DwtFontList 
DwtCallbackPtr 
unsigned char 
unsigned char 
DwtCallbackPir 


B.6 Dialog Box Popup 


Default 


Determined by the geometry 
manager 


Determined by the geometry 
manager 


0 pixels 

0 pixels 

1 pixel 

Default foreground color 
Null 

Default background color 
Null 

Default color map 

True 


The bitwise AND of the 
parent widget’s sensitive 
and ancestor_sensitive 
atiributes 


Null 
Depth of the parent window 
Null 
True 


The parent screen 
Null 


Default foreground color 
Default foreground color 
Null 

Null 

False 

XUI Toolkit font 

Null 

DwtFontUnits 
DwtModeless 

Null 
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B.6 Dialog Box Popup 


Table B-6 (Cont.) Dialog Box Pop-Up Attributes 





Attribute C Name C Data Type Default 
Widget-Specific Attributes 

text_merge_ DwtNtextMerge Translations XtTranslations Null 
translations 

margin_width DwitNmarginWidth Dimension 3 pixels 
margin_height DwtNmarginHeight Dimension 3 pixels 
default_position DwtNdefaultPosition Boolean False 
child_overlap DwtNchildOverlap Boolean True 

resize DwtNresize unsigned char DwtResizeGrowOnly 
no_resize DwtNnoResize Boolean True 

title DwiNtitle DwiCompString Widget name 
map_callback DwtNmapCallback DwtCallbackPtr Null 
unmap_callback DwtNunmapCallback DwtCallbackPtr Null 


take_focus 


auto_unmanage 
default_button 
cancel_button 


grab_key_syms _ 


grab_merge_ 
translations 


DwiNtakeFocus 


DwtNautoUnmanage 
DwtNdefaultBuiton 
DwtNcancelButton 
DwtNgrabKeySyms 


DwtNgrabMergeTranslations 


Boolean 


Boolean 
Widget 
Widget 
KeySym 


XtTranslations 


True for modal dialog box; 
false for modeless dialog 
box 


True 
Null 
Null 


The default array contains 
the Tab key symbol. 


See DIALOG BOX CREATE 
for the default syntax. 





File Selection 


See Table B—7 for a summary of file selection widget attributes. 


Table B—7 File Selection Attributes 


Attribute 


Core Widget Attributes 


X 


width 
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C Name 


DwtNx 
DwtNy 


DwtNwidth 


Cc Data Type 


Position 
Position 


Dimension 


Default 


Centered in the parent 
window 


Centered in the parent 
window 


Width of the list box, plus the 
width of the push buttons, 
plus three times margin_ 
width 
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Table B-7 (Cont.) File Selection Attributes 


Attribute 


Core Widget Attributes 


height 


border_width 

border 
border_pixmap 
background 
background_pixmap 
colormap 

sensitive 
ancestor_sensitive 


accelerators 
depth 
translations 


mapped_when_ 
managed 


screen 
destroy_callback 


C Name 


DwtNheight 


DwiNborderWidth 
DwtNborder 
DwtNborderPixmap 
DwtNbackground 
DwtNbackgroundPixmap 
DwtNcolormap 
DwtNsensitive 
DwtNancestorSensitive 


DwtNaccelerators 
DwtNdepth 

DwiNtranslations 
DwitNmappedWhenManaged 


DwiNscreen 
DwtNdestroyCallback 


Dialog Box Pop-Up Attributes 


foreground 
highlight 
highlight_pixmap 
user_data 
direction_r_to_| 
font 
help_callback 
units 

style 
focus_callback 


text_merge_ 
translations 


DwtNforeground 
DwtNhighlight 
DwtNhighlightPixmap 
DwtNuserData 
DwtNdirectionRToL 
DwtNfont 
DwtNhelpCaliback 
DwtNunits 

DwiNstyle 
DwtNfocusCallback 
DwtNtextMergeTranslations 


C Data Type 


Dimension 


Dimension 
Pixel 
Pixmap 
Pixel 
Pixmap 
Colormap 
Boolean 
Boolean 


XtTranslations 
int 
XtTranslations 
Boolean 


Screen * 
DwtCallbackPtr 


Pixel 

Pixel 

Pixmap 
Opaque * 
Boolean 
DwiFontList 
DwtCallbackPtr 
unsigned char 
unsigned char 
DwtCallbackPtr 
XtTranslations 
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Default 


Height of the list box, plus 
the height of the text edit 
field, plus the height of 
the label, plus three times 
margin_height 


1 pixel 

Default foreground color 
Null 

Default background color 
Null 

Default color map 

True 


The bitwise AND of the 
parent widget’s sensitive 
and ancestor_sensitive 
attributes 


Null 
Depth of the parent window 
Null 
True 


The parent screen 
Null 


Default foreground color 
Default foreground color 
Null 

Null 

False 

XUI Toolkit font 

Null 

DwtFontUnits 
DwitModeless 

Null 

Null 
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B-13 


Summary of Widget Attributes (C Binding) 
B.7 File Selection 


Table B-7 (Cont.) File Selection Attributes 


Attribute 


C Name 


Dialog Box Pop-Up Attributes 


margin_width 
margin_height 
default_position 
child_overlap 
resize 

no_resize 

title 
map_callback 
unmap_callback 
take_focus 


auto_unmanage 
default_button 
cancel_button 


Selection Attributes 


label 

value 
selection_label 
ok_label 
cancel_label 


activate_callback 


cancel_callback 


no_match_callback 
visible_item_count 


items 
item_count 
must_match 
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DwtNmarginWidth 
DwtNmarginHeight 
DwiNdefaultPosition 
DwtNchildOverlap 
DwtNresize 
DwtNnoResize 
DwtNtitle 
DwitNmapCalliback 
DwitNunmapCallback 
DwtNtakeFocus 


DwitNautoUnmanage 
DwiNdefaultButton 
DwtNcancelButton 


DwtNlabel 

DwtNvalue 
DwtNselectionLabel 
DwtNokLabel 
DwtNcancelLabel 
DwtNactivateCallback 
DwtNeancelCallback 
DwtNnoMatchCallback 
DwiNvisibleltemsCount 
DwtNitems 
DwtNitemsCount 
DwtNmustMatch 


C Data Type 


Dimension 
Dimension 
Boolean 
Boolean 
unsigned char 
Boolean 
DwtCompString 
DwtCallbackPtr 
DwtCallbackPtr 
Boolean 


Boolean 
Widget 
Widget 


DwiCompString 
DwtCompSiring 
DwtCompString 
DwtCompString 
DwtCompString 
DwtCallbackPtr 
DwtCallbackPtr 
DwtCallbackPtr 
int 


. DwtCompString * 


int 
Boolean 


Default 


5 pixels 

5 pixels 

False 

True 
DwtResizeGrowOnly 
True 

“Open” 

Null 

Null 


True for modal dialog box; 
false for modeless dialog 
box 


True 
Null 
Null 


“Items” 
Null string 
“Files in” 
“OK” 
“Cancel” 
Null 

Null 

Null 

8 items 
Null 

0 items 
False 
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B.7 File Selection 


Table B-7 (Cont.) File Selection Attributes 





Attribute C Name C Data Type Default 

Widget-Specific Attributes 

filter_label DwiNfilterLabel DwtCompString “File filter” 

apply_label DwtNapplyLabel DwiCompString “Filter” 

dir_mask DwtNdirMask DwtCompString a 

dir_spec DwtNdirSpec DwtCompString Null string 

file_search_proc DwtNfileSearchProc VoidProc Default file search procedure 
list_updated DwtNlistUpdated Boolean False 

Help 


See Table B-8 for a summary of help widget attributes. 


Table B-8 Help Attributes 





Attribute C Name C Data Type Default 

Core Widget Attributes 

x DwtNx Position Determined by the geometry 
manager 

y DwiNy Position Determined by the geometry 
manager 

width DwtNwidth Dimension Cannot be set by the caller 

height DwtNheight Dimension Cannot be set by the caller 

border_width DwtNborderWidth Dimension 1 pixel 

border DwtNborder Pixel Default foreground color 

border_pixmap DwtNborderPixmap Pixmap Null 

background DwtNbackground Pixel Default background color 

background_pixmap DwtNbackgroundPixmap Pixmap Null 

colormap DwtNcolormap Colormap Default color map 

sensitive DwiNsensitive Boolean True 

ancestor_sensitive DwtNancestorSensitive Boolean The bitwise AND of the 
parent widget’s sensitive 
and ancestor_sensitive 
attributes 

accelerators DwtNaccelerators XtTranslations Null 


(continued on next page) 
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B.8 Help 


Table B-8 (Cont.) Help Attributes 





Attribute C Name C Data Type Default 

Core Widget Attributes 

depth DwtNdepth int Depth of the parent window 
translations DwtNtranslations XtTranslations Null 

mapped_when_ DwtNmappedWhenManaged Boolean True 

managed 

screen DwtNscreen Screen * The parent screen 


destroy_cailback 


DwtNdestroyCaliback 


Common Widget Attributes 


foreground 
highlight 
highlight_pixmap 
user_data 
direction_r_to_| 
font 
help_callback 


DwtNforeground 
DwtNhighlight 
DwitNhighlightPixmap 
DwtNuserData 
DwtNdirectionRToL 
DwtNfont 
DwtNhelpCallback 


Widget-Specific Attributes 


about_label 
add_topic_label 
application_name 
badframe_message 


badlib_message 


cols 

copy_label 
default_position 
dismiss_label 
edit_label 
erroropen_message 
exit_label 
file_label 
first_topic 
glossary_label 
glossary_topic 
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DwitNaboutLabel 
DwtNaddTopicLabel 
DwtNapplicationName 
DwiNbadframeMessage 


DwtNbadlibMessage 


DwtNcols 
DwtNcopyLabel 
DwtNdefaultPosition 
DwtNdismissLabel 
DwtNeditLabel 
DwtNerroropenMessage 
DetNexitLabel 
DwtNfileLabel 
DwtNfirstTopic 
DwtNglossaryLabel 
DwtNglossary Topic 


DwtCallbackPir 


Pixel 

Pixel 

Pixmap 
Opaque * 
Boolean 
DwiFontList 
DwtCalibackPtr 


DwtCompString 
DwtCompString 
DwtCompString 
DwtCompString 


DwtCompString 


int 
DwtCompString 
Boolean 
DwtCompString 
DwtCompString 
DwtCompString 
DwtCompString 
DwtCompString 
DwtCompString 
DwtCompString 
DwtCompString 


Null 


Default foreground color 
Default foreground color 
Null 

Null 

False 

XUI Toolkit font 

Null 


“About” 
“Additional topics:” 
Null 


“Couldn’t find frame %s in 
%x library\n” 


“Couldn't open %s library 
\n” 


55 character cells 
“Copy” 

True 

“Dismiss” 

“Edit” 

“Error opening file %s\n” 
“Exit” 

“File” 

Null 

“Glossary” 

Null 
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Table B-8 (Cont.) Help Attributes 


Attribute 


C Name 


Widget-Specific Attributes 


goback_label 
goover_label 
goto_label 
help_font 
help_label 
helpmessage_title 
helpmessage_title_ 
type 

history_label 
historybox_label 
keyword_label 
keywords _label 
library_spec 
library_type 
nokeyword_message 


notitle_message 


nulllib_ message 
nulltopic_message 


overview_topic 
rows 

saveas_label 
search_apply_label 


searchkeywordbox_ 
label 


search_label 
searchtitlebox_label 
selectall_labe!l 
title_label 
titles_label 
topictitles_label 


DwitNgobackLabel 
DwtNgooverLabel 
DwtNgotoLabel 
DwtNhelpFont 
DwtNhelpLabel 
DwtNhelpmessage Title 
DwtNhelpmessage Title Type 


DwtNhistoryLabel 
DwtNhistoryboxLabel 
DwtNkeywordLabel 
DwtNkeywordsLabel 
DwtNlibrarySpec 
DwiNlibraryType 
DwtNnokeywordMessage 


DwiNnotitleMessage 


DwtNnulllibMessage 
DetNnulltopicMessage 


DwtNoverview Topic 
DwtNrows 

DwtNsaveasLabel 
DwiNsearchApplyLabel 
DwitNsearchkeywordboxLabel 


DwtNsearchLabel 
DwtNsearchtitleboxLabel 
DwtNselectallLabel 
DwiNtitleLabel 
DwiNtitlesLabel 
DwtNtopictitlesLabel 


C Data Type 


DwtCompString 
DwtCompString 
DwtCompString 
DwtFontList 
DwtCompSiring 
DwiCompString 
unsigned char 


DwtCompString 
DwtCompString 
DwtCompSiring 
DwtCompString 
DwtCompString 
DwtCompSiring 
DwtCompString 


DwtCompString 


DwtCompString 
DwicompString 


DwtCompString 
int 

DwtCompString 
DwitCompString 
DwtCompString 


DwtCompString 
DwtCompString 
DwitCompString 
DwtCompString 
DwtCompString 
DwtCompString 


B.8 Help 


Default 


“Go Back” 

“Go to Overview” 
“Go To” 

The default help font 
“Help” 

“Message” 
DwtCString 


“History...” 

“Help Topic History” 
“Keyword...” 
“Keyword:” 

Null 

DwitTextLibrary 


“Couldn't find keyword 
%s\n” 


“No title to match 
string%s\n” 


“No library specified\n” 


“No first topic and overview 
topic specified\n” 


Null 

20 lines 

“Save As...” 

“Apply” 

“Search Topic Keywords” 


“Search” 

“Search Topic Titles” 
“Select All” 

“Title...” 

“Title:” 

“Topic Titles:” 





(continued on next page) 


B-17 


B.9 


Summary of Widget Attributes (C Binding) 


B.8 Help 


Table B-8 (Cont.) Help Attributes 


Attribute 


C Name 


Widget-Specific Attributes 


view_label 
visitglos_label 
visit_label 
unmap_callback 


DwtNviewLabel 
DwtNvisitglosLabel 
DwtNvisitLabel 
DwtNunmapCallback 


C Data Type 


DwitCompString 
DwtCompString 
DwtCompString 
DwtCompString 


Default 


“View” 

“Visit Glossary” 
“Visit” 

Null 





Label 


See Table B—9 for a summary of label widget attributes. 


Table B-9 Label Attributes 


Attribute 


Core Widget Attributes 


Xx 


width 


height 


border_width 

border 
border_pixmap 
background 
background_pixmap 
colormap 

sensitive 
ancestor_sensitive 


accelerators 


B-18 


C Name 


DwtNx 
DwtNy 


DwitNwidth 


DwtNheight 


DwiNborderWidth 
DwtNborder 
DwitNborderPixmap 
DwtNbackground 
DwtNbackgroundPixmap 
DwtNcolormap 
DwtNsensitive 
DwtNancestorSensitive 


DwtNaccelerators 


C Data Type 


Position 
Position 


Dimension 


Dimension 


Dimension 
Pixel 
Pixmap 
Pixel 
Pixmap 
Colormap 
Boolean 
Boolean 


XtTranslations 


Default 


Determined by the geometry 
manager 


Determined by the geometry 
manager 


Width of the label or pixmap, 
plus two times margin_ 
width 


Height of the label or 
pixmap, plus two times 
margin_height 


0 pixels 

Default foreground color 
Null 

Default background color 
Null 

Default color map 

True 


The bitwise AND of the 
parent widget’s sensitive 
and ancestor_sensitive 
attributes 


Null 
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Table B-9 (Cont.) Label Attributes 


B.9 Label 





Attribute C Name C Data Type Default 

Core Widget Attributes | 

depth DwtNdepth int Depth of the parent window 
translations DwtNiranslations XtTranslations Null 

mapped_when_ DwtNmappedWhenManaged Boolean True 

managed 

screen DwtNscreen Screen * The parent screen 


destroy_callback 


DwtNdestroyCallback 


Common Widget Attributes 


foreground 
highlight 
highlight_pixmap 
user_data 
direction_r_to_| 
font 
help_cailback 


DwtNforeground 
DwtNhighlight 
DwtNhighlightPixmap 
DwtNuserData 
DwtNdirectionRToL 
DwtNfont 
DwtNhelpCallback 


Widget-Specific Attributes 


label_type 
label 
margin_width 


margin_height 


alignment 
pixmap 
margin_left 
margin_right 
margin_top 
margin_bottom 
conform_to_text 


DwtNlabelType 
DwiNlabel 
DwtNmarginWidth 


DwtNmarginHeight 


DwtNalignment 
DwtNpixmap 
DwtNmarginLeft 
DwtNmarginRight 
DwtNmarginTop 
DwtNmarginBottom 
DwtNconformToText 


DwtCallbackPtr 


Pixel 

Pixel 

Pixmap 
Opaque * 
Boolean 
DwtFontList 
DwtCallbackPtr 


unsigned char 
DwtCompString 
Dimension 


Dimension 


unsigned char 
Pixmap 
Dimension 
Dimension 
Dimension 
Dimension 
Boolean 


Null 


Default foreground color 
Default foreground color 
Null 

Null 

False 

XUI Toolkit font 

Null 


Compound string 
Widget name 


2 pixels for text; 0 pixels for 
pixmap 


2 pixels for text; 0 pixels for 
pixmap 


Center alignment 
Null 

0 pixels 

0 pixels 

0 pixels 

0 pixels 


True if width and height 
are zero; false if width and 
height are not zero 
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B.10 List Box 





List Box 


See Table B~10 for a summary of list box widget attributes. 


Table B-—10 List Box Attributes 


Attribute 


Core Widget Attributes 


X 


width 


height 


border_wiath 

border 
border_pixmap 
background 
background_pixmap 
colormap 

sensitive 
ancestor_sensitive 


accelerators 
depth 
translations 


mapped_when_ 
managed 


screen 
destroy_callback 


B-20 


C Name 


DwitNx 
DwtNy 


DwtNwidth 


DwtNheight 


DwtNborderWidth 
DwtNborder 
DwtNborderPixmap 
DwtNbackground 
DwtNbackgroundPixmap 
DwitNcolormap 
DwtNsensitive 
DwtNancestorSensitive 


DwtNaccelerators 
DwtNdepth 

DwtNtranslations 
DwtNmappedWhenManaged 


DwtNscreen 
DwiNdestroyCallback 


C Data Type 


Position 
Position 


Dimenision 


Dimension 


Dimension 
Pixel 
Pixmap 
Pixel 
Pixmap 
Colormap 
Boolean 
Boolean 


XtTranslations 
int 
XtTranslations 
Boolean 


Screen * 
DwtCallbackPtr 


Default 


Determined by the geometry 
manager 


Determined by the geometry 
manager 


As large as necessary to 
hold the longest item without 
exceeding the size of its 
parent 


As large as necessary to 
hold the number of items 
specified by visible_item_ 
count without exceeding the 
size of its parent 


1 pixel 

Default foreground color 
Null 

Default background color 
Null 

Default color map 

True 


The bitwise AND of the 
parent widget’s sensitive 
and ancestor_sensitive 
attributes 


Null 
Depth of the parent window 
Null 
True 


The parent screen 
Null 
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Table B-10 (Cont.) List Box Attributes 


Attribute 


C Name 


Common Widget Attributes 


foreground 
highlight 
highlight_pixmap 
user_data 
direction_r_to_| 
font 
help_callback 


DwitNforeground 
DwiNhighlight 
DwtNhighlightPixmap 
DwtNuserData 
DwtNdirectionRToL 
DwtNfont 
DwtNhelpCallback 


Scroll Window Attributes 


h_scroll 
v_scroll 
work_window 


shown_value_ 
automatic_horiz 


shown_value_ 
automatic_vert 


DwiNhorizontalScrollBar 
DwtNverticalScrollBar 
DwtNworkWindow 
DwtNshownValueAutomaticHoriz 


DwtNshownValueAutomaticVert 


Widget-Specific Attributes 


margin_width 
margin_height 
spacing 

items 

item_count 
selected_items. 
selected_items_count 
visible_item_count 


single_selection 
resize 

horiz 
single_callback 


DwtNmarginWidth 
DwtNmarginHeight 
DwtNspacing 

DwiNitems 
DwtNitemsCount 
DwtNselecteditems 
DwiNselecteditemsCount 
DwiNvisibleltemsCount 


DwtNsingleSelection 
DwiNresize 
DwtNhorizontal 
DwiNsingleCallback 


C Data Type 


Pixel 

Pixel 

Pixmap 
Opaque * 
Boolean 
DwiFontList 
DwtCallbackPir 


Widget 
Widget 
Widget 
Boolean 


Boolean 


Dimension 
Dimension 
Dimension 
DwtCompString * 
int 
DwiCompString * 
int 

int 


Boolean 
unsigned char 
Boolean 
DwtCallbackPtr 


B.10 List Box 


Default 


Default foreground color 
Default foreground color 
Null 

Null 

False 

Not supported 

Not supported 


Null 
Null 
Null 
True 


False 


10 pixels 
4 pixels 
1 pixel 
Null 

0 items 
Null 

0 items 


As many items as can fit in 
the core attribute height 


True 
DwtGrowOnly 
False 

Null 
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B.10 List Box 


Table B—10 (Cont.) List Box Attributes 


Attribute 


C Name 


Widget-Specific Attributes 


single_confirm_ 
callback 


extend_callback 


extend_confirm_ 
callback 


DwtNsingleConfirmCallback 


DwtNextendCallback 


DwtNextendConfirmCallback 


C Data Type 


DwitCallbackPtr 


DwtCallbackPtr 
DwtCallbackPtr 


Default 


Null 


Null 
Null 





Main Window 


See Table B—11 for a summary of main window widget attributes. 


Table B—11 Main Window Attributes 


Attribute 


Core Widget Attributes 


X 


y 


width 

height 

border_width 

border 
border_pixmap 
background 
background_pixmap 
colormap 

sensitive 
ancestor_sensitive 


accelerators 
depth 


Cc Name 


DwitNx 
DwiNy 


DwtNwidth 

DwtNheight 
DwtNborderWidth 
DwtNborder 
DwtNborderPixmap 
DwtNbackground 
DwtNbackgroundPixmap 
DwtNcolormap 
DwtNsensitive 
DwtNancestorSensitive 


DwitNaccelerators 
DwtNdepth 


C Data Type 


Position 
Position 


Dimension 
Dimension 
Dimension 
Pixel 
Pixmap 
Pixel 
Pixmap 
Colormap 
Boolean 
Boolean 


XtTranslations 
int 


Default 


Determined by the geometry 
manager 


Determined by the geometry 
manager 


5 pixels 

5 pixels 

1 pixel 

Default foreground color 
Null 

Default background color 
Null 

Default color map 

True 


The bitwise AND of the 
parent widget’s sensitive 
and ancestor_sensitive 
attributes 

Null 


Depth of the parent window 
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B.11 Main Window 


Table B-11 (Cont.) Main Window Attributes 
Attribute C Name C Data Type Default 





Core Widget Attributes 





translations DwtNtranslations XtTranslations Null 
mapped_when_ DwtNmappedWhenManaged Boolean True 

managed 

screen DwtNscreen Screen * The parent screen 
destroy_ callback DwtNdestroyCallback DwtCallbackPtr Null 





Common Widget Attributes 





foreground DwtNforeground Pixel Default foreground color 
highlight DwtNhighlight Pixel Not supported 
highlight_pixmap DwtNhighlightPixmap Pixmap Not supported 
user_data DwtNuserData Opaque * Null 

direction_r_to_| DwtNdirectionRToL Boolean False 

font DwtNfont DwtFontList Not supported 
help_callback DwtNhelpCallback DwtCailbackPir Null 


Widget-Specific Attributes 





command_window DwitNcommandWindow Widget Null 
work_window DwtNworkWindow Widget Null 
menu_bar DwtNmenuBar Widget Null 
horizontal_scroll_bar DwtNhorizontalScrollBar Widget Null 
vertical_scroll_bar DwtNverticalScrollBar Widget Null 
accept_focus DwtNacceptFocus Boolean False 
focus_callback DwtNfocusCallback DwtCallbackPtr Null 
Menu Bar 


See Table B-12 for a summary of menu bar widget attributes. 
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B.12 Menu Bar 


Table B—12 Menu Bar Attributes 


Attribute 


Core Widget Attributes 


xX 


y 


width 
height 


border_width 

border 
border_pixmap 
background 
background_pixmap 
colormap 

sensitive 
ancestor_sensitive 


accelerators 
depth 
translations 


mapped_when_ 
managed 


screen 
destroy_callback 


C Name 


DwtNx 
DwtNy 


DwtNwidth 
DwtNheight 


DwtNborderWidth 
DwitNborder 
DwtNborderPixmap 
DwtNbackground 
DwtNbackgroundPixmap 
DwtNcolormap 
DwtNsensitive 
DwtNancestorSensitive 


DwtNaccelerators 
DwtNdepth 

DwiNtranslations 
DwitNmappedWhenManaged 


DwtNscreen 
DwtNdestroyCaliback 


Common Widget Attributes 


foreground 
highlight 
highlight_pixmap 
user_data 
direction_r_to_| 
font 
help_callback 
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DwtNforeground 
DwtNhighlight 
DwtNhighlightPixmap 
DwtNuserData 
DwtNdirectionRToL 
DwitNfont 
DwtNhelpCallback 


C Data Type 


Position 
Position 


Dimension 
Dimension 


Dimension 
Pixel 
Pixmap 
Pixel 
Pixmap 
Colormap 
Boolean 
Boolean 


XtTranslations 
int 
XtTranslations 
Boolean 


Screen * 
DwtCallbackPtr 


Pixel 

Pixel 

Pixmap 
Opaque * 
Boolean 
DwtFontList 
DwtCallbackPtr 


Default 


Determined by the geometry 
manager 


Determined by the geomeiry 
manager 


16 pixels 


Number of lines needed to 
display all entries 


1 pixel 

Default foreground color 
Null 

Default background color 
Null 

Default color map 

True 


The bitwise AND of the 
parent widget’s sensitive 
and ancestor_sensitive 
attributes 


Null 
Depth of the parent window 
Null 
True 


The parent screen 
Null 


Default foreground color 
Default foreground color 

Null 

Null 

False 

Used only by gadget children 
Null 
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Table B—12 (Cont.) 
Attribute 


Menu Attributes 


orientation 
spacing 
adjust_margin 
margin_width 
margin_height 
entry_border 
menu_alignment 
entry_alignment 
menu_packing 


menu_num_columns 
menu_radio 


radio_always_one 


menu_is__ 
homogeneous 


menu_eniry_class 


menu_history 
entry_callback 
map_callback 
unmap_callback 
menu_help_widget 
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Menu Bar Attributes 


C Name 


DwtNorientation 
DwiNspacing 
DwtNadjustMargin 
DwtNmarginWidth 
DwtNmarginHeight 
DwtNentryBorder 
DwtNmenuAlignment 
DwtNentryAlignment 
DwtNmenuPacking 


DwtNmenuNumColumns 
DwtNmenuRadio 


DwtNradioAlwaysOne 
DwtNmenulsHomogeneous 


DwtNmenuEniryClass 


DwtNmenuHistory 
DwtNentryCallback 
DwtNmapCallback 
DwtNunmapCallback 
DwtNmenuHelpWidget 


C Data Type 


unsigned char 
Dimension 
Boolean 
Dimension 
Dimension 
Dimension 
Boolean 
unsigned char 
unsigned char 


short 
Boolean 


Boolean 
Boolean 


WidgetClass 


Widget 
DwtCallbackPtr 
DwtCallbackPitr 
DwtCallbackPtr 
Widget 
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Default 


DwtOrientationVertical 

1 pixel 

True 

3 pixels 

3 pixels 

0 pixels 

True 
DwtAlignmentBeginning 


DwitMenuPackingTight for ail 
menu types except for radio 
boxes. Radio boxes default 
to DwitMenuPackingColumn. 


1 row or column 


False, except for radio 
boxes, which default to true 


True 


False except for radio boxes, 
which default to true 


Null except for radio 
boxes, which default to 
togglebuttonwidgetclass 


Null 
Null 
Null 
Null 
Null 





Menu 


See Table B-13 for a summary of menu widget attributes. 
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B.13 Menu 


’ Table B—13 Menu Attributes 


Attribute 


Core Widget Attributes 


x 


—< 


width 


height 


border_width 

border 
border_pixmap 
background 
background_pixmap 
colormap 

sensitive 
ancestor_sensitive 


accelerators 
depth 
translations 


mapped_when_ 
managed 


screen 
destroy_callback 


C Name 


DwtNx 
DwiNy 


DwtNwidth 


DwtNheight 


DwitNborderWidth 
DwtNborder 
DwtNborderPixmap 
DwtNbackground 
DwtNbackgroundPixmap 
DwtNcolormap 
DwtNsensitive 
DwiNancestorSensitive 


DwtNaccelerators 
DwtNdepth 

DwtNiranslations 
DwtNmappedWhenManaged 


DwtNscreen 
DwtNdestroyCaliback 


C Data Type 


Position 
Position 


Dimension 


Dimension 


Dimension 
Pixel 
Pixmap 
Pixel 
Pixmap 
Colormap 
Boolean 
Boolean 


XtTranslations 
int 
XtTranslations 
Boolean 


Screen * 


~ DwtCallbackPtr 


Default 


Determined by the geometry 
manager 
Determined by the geometry 
manager 


lf orientation is vertical, 
width is the maximum 
entry width or 16 pixels. If 
orientation is horizontal, 
width is the sum of width 
and spacing or 16 pixels. 


If orientation is vertical, 
height is the sum of height 
and spacing or 16 pixels. 

lf orientation is horizontal, 
height is the maximum entry 
height or 16 pixels. 


1 pixel 

Default foreground color 
Null 

Default background color 
Null 

Default color map 

True 


The bitwise AND of the 
parent widget’s sensitive 
and ancestor_sensitive 
attributes 


Null 
Depth of the parent window 
Null 
True 


The parent screen 
Null 





Common Widget Attributes 





foreground 
highlight 
highlight_pixmap 
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DwtNforeground 
DwtNhighlight 
DwtNhighlightPixmap 


Pixel 
Pixel 
Pixmap 


Default foreground color 
Default foreground color 
Null 


(continued on next page) 
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Table B—13 (Cont.) Menu Attributes 


Attribute 


C Name 


Common Widget Attributes 


user_data 
direction_r_to_| 
font 

help_ callback 


DwitNuserData 
DwtNdirectionRToL 
DwtNfont 
DwtNhelpCallback 


Widget-Specific Attributes 


orientation 
spacing 
adjust_margin 
margin_width 
margin_height 
entry_border 
menu_alignment 
entry_alignment 
menu_packing 


menu_num_columns 
menu_radio 


radio_always_one 


menu_is__ 
homogeneous 


menu_entry_class 


menu_history 
entry_callback 
map_cailback 
unmap_callback 
menu_help_widget 


DwtNorientation 
DwtNspacing 
DwtNadjustMargin 
DwtNmarginWidth 
DwtNmarginHeight 
DwtNentryBorder 
DwiNmenuAlignment 
DwtNentryAlignment 
DwiNmenuPacking 


DwtNmenuNumColumns 
DwtNmenuRadio 


DwtNradioAlwaysOne 
DwtNmenulsHomogeneous 


DwitNmenuEntryClass 


DwtNmenuhistory 
DwtNentryCallback 
DwtNmapCallback 
DwtNunmapCallback 
DwtNmenuHelpWidget 


C Data Type 


Opaque * 
Boolean 
DwtFoniList 
DwtCallbackPtr 


unsigned char 
Dimension 
Boolean 
Dimension 
Dimension 
Dimension 
Boolean 
unsigned char 
unsigned char 


int 
Boolean 


Boolean 
Boolean 


WidgetClass 


Widget 
DwtCallbackPtr 
DwtCallbackPtr 
DwtCallbackPtr 
Widget 


B.13 Menu 


Default 


Null 

False 

XUI Toolkit font 
Null 


DwtOrientationVertical 

1 pixel 

True 

3 pixels 

3 pixels 

0 pixels 

True 

Alignment at the beginning 


DwtMenuPackingTight for all 
menu types except for radio 
boxes. Radio boxes default 
to DwtMenuPackingColumn. 


1 column 


False except for radio boxes, 
which default to true 


True 


False except for radio boxes, 
which default to true 


Null except for radio 
boxes, which default to 
togglebuttonwidgetclass 


Null 
Null 
Null 
Null 
Null 
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Menu Popup 


See Table B-14 for a summary of menu pop-up widget attributes. 


Table B-14 Menu Popup Attributes 





Attribute C Name C Data Type Default 

Core Widget Attributes 

X DwtNx Position Determined by the geometry 
manager 

y DwtNy Position Determined by the geometry 
manager 

width DwtNwidth Dimension As large as necessary to 
hold all child widgets 

height DwtNheight Dimension As large as necessary to 
hold all child widgets 

border_width DwitNborderWidth Dimension 1 pixel 

border DwtNborder Pixel Default foreground color 

border_pixmap DwtNborderPixmap Pixmap Null 

background DwtNbackground Pixel Default background color 

background_pixmap DwtNbackgroundPixmap Pixmap Null 

colormap DwitNcolormap Colormap Default color map 

sensitive DwtNsensitive Boolean True 

ancestor_sensitive DwtNancestorSensitive Boolean The bitwise AND of the 
parent widget’s sensitive 
and ancestor_sensitive 
attributes 

accelerators DwtNaccelerators XtTranslations Null 

depth DwtNdepth int Depth of the parent window 

translations DwtNtranslations XtTranslations Null 

mapped_when_ DwtNmappedWhenManaged Boolean True 

managed 

screen DwiNscreen Screen * The parent screen 


destroy_callback 


DwtNdestroyCallback 


Common Widget Attributes 


DwtCallbackPir 


Null 





foreground 
highlight 
highlight_pixmap 


DwtNforeground 
DwiNhighlight 
DwtNhighlightPixmap 


Pixel 
Pixel 
Pixmap 


Default foreground color 
Default foreground color 
Null 
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Table B-—14 (Cont.) Menu Popup Attributes 


B.14 Menu Popup 








Attribute C Name C Data Type Default 
Common Widget Attributes 

user_data DwtNuserData Opaque * Null 
direction_r_to_| DwtNdirectionRToL Boolean False 

font DwtNfont DwtFontList XUI Toolkit font 
help_callback DwtNhelpCallback DwitCallbackPtr Null 
Widget-Specific Attributes 

orientation DwtNorientation unsigned char DwtOrientationVertical 
spacing DwtNspacing Dimension 1 pixel 
adjust_margin DwtNadjustMargin Boolean True 
margin_width DwiNmarginWidth Dimension 3 pixels 
margin_height DwiNmarginHeight Dimension 3 pixels 
entry_border DwtNentryBorder Dimension 0 pixels 
menu_alignment DwtNmenuAlignment Boolean True 


entry_alignment 
menu_packing 


menu_num_columns 
menu_radio 


radio_always_one 


menu_is _ 
homogeneous 


menu_eniry_class 


menu_history 
entry_callback 
map_callback 
unmap_callback 
menu_help_widget 


DwiNentryAlignment 
DwtNmenuPacking 


DwtNmenuNumColumns 
DwtNmenuRadio 


DwtNradioAlwaysOne 
DwitNmenulsHomogeneous 


DwtNmenuEntryClass 


DwiNmenuhistory 
DwtNentryCaliback 
DwtNmapCallback 
DwtNunmapCallback 
DwtNmenuHelpWidget 


unsigned char 
unsigned char 


short 
Boolean 


Boolean 
Boolean 


WidgetClass 


Widget 
DwtCallbackPtr 
DwtCallbackPtr 
DwtCallbackPtr 
Widget 


DwiAlignmentBeginning 


DwitMenuPackingTight for all 
menu types except for radio 
boxes. Radio boxes default 
to DwtMenuPackingColumn. 


1 column 


False except for radio boxes, 
which default to true 


True 


False except for radio boxes, 
which default to true 


Null except for radio 
boxes, which default to 
togglebuttonwidgetclass 


Null 
Null 
Null 
Null 
Null 





Menu Pulldown 


See Table B—-15 for a summary of menu pull-down widget attributes. 
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Table B—15 Menu Pulldown Attributes 





Attribute C Name C Data Type Default 

Core Widget Attributes 

X DwtNx Position Not supported 

y DwtNy Position Not supported 

width DwtNwidth Dimension As large as necessary to 
hold all child widgets 

height DwtNheight Dimension As large as necessary to 
hold all child widgets 

border_width DwtNborderWidth Dimension 1 pixel 

border DwtNborder Pixel Default foreground color 

border_pixmap DwtNborderPixmap Pixmap Null 

background DwtNbackground Pixel Default background color 

background_pixmap DwtNbackgroundPixmap Pixmap Null 

colormap DwtNcolormap | Colormap Default color map 

sensitive DwtNsensitive Boolean True 

ancestor_sensitive DwtNancestorSensitive Boolean The bitwise AND of the 
parent widget’s sensitive 
and ancestor_sensitive 
attributes 

accelerators DwtNaccelerators XtTranslations Null 

depth DwtNdepth int Depth of the parent window 

translations DwtNitranslations XtTranslations Null 

mapped_when_ DwtNmappedWhenManaged Boolean True 

managed 

screen DwtNscreen Screen * The parent screen 


destroy_callback 


- DwtNdestroyCallback 


Common Widget Attributes 


foreground 
highlight 
highlight_pixmap 
user_data 
direction_r_to_| 
font 
help_callback 
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DwiNforeground 
DwtNhighlight 
DwtNhighlightPixmap 
DwtNuserData 
DwtNdirectionRToL 
DwiNfont 
DwtNhelpCallback 


DwtCallbackPtr 


Pixel 

Pixel 

Pixmap 
Opaque * 
Boolean 
DwtFontList 
DwtCalibackPtr 


Null 


Default foreground color 
Default foreground color 
Null 

Null 

False 

XU! Toolkit font 

Null 


(continued on next page) 
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Table B-15 (Cont.) Menu Pulldown Attributes 





Attribute C Name C Data Type Default 

Menu Attributes 

orientation DwtNorientation unsigned char DwtOrientationVertical 
spacing DwtNspacing Dimension 1 pixel 

adjust_margin DwtNadjustMargin Boolean True 

margin_width DwtNmarginWidth Dimension 3 pixels 
margin_height DwiNmarginHeight Dimension 3 pixels 

entry_border DwitNentryBorder Dimension 0 pixels 
menu_alignment DwiNmenuAlignment Boolean True 


entry_alignment 
menu_packing 


menu_num_columns 
menu_radio 


radio_always_one 


menu_is_ 
homogeneous 


menu_entry_class 


menu_history 
entry_callback 
map_callback 
unmap_cailback 
menu_help_widget 


DwtNentryAlignment 
DwitNmenuPacking 


DwtNmenuNumColumns 
DwtNmenuRadio 


DwtNradioAlwaysOne 
DwtNmenulsHomogeneous 


DwtNmenuEntryClass 


DwtNmenuhistory 
DwtNentryCailback 
DwitNmapCallback 
DwtNunmapCallback 
DwtNmenuHelpWidget 


unsigned char 
unsigned char 


int 
Boolean 


Boolean 
Boolean 


WidgetClass 


Widget 
DwtCallbackPtr 
DwtCallbackPtr 
DwtCallbackPtr 
Widget 


DwtAlignmentBeginning 


DwtMenuPackingTight for all 
menu types except for radio 
boxes. Radio boxes default 
to DwtMenuPackingColumn. 


1 column 


False except for radio boxes, 
which default to true 


True 


False except for radio boxes, 
which default to true 


Null except for radio 
boxes, which default to 
togglebuttonwidgetclass 


Null 
Null 
Null 
Null 
Null 








Message Box 


See Table B-16 for a summary of message box widget attributes. 


Table B—16 Message Box Attributes 


Attribute 


Core Widget Attributes 


~< 


C Name 


DwitNx 


C Data Type 


Position 


Default 


Determined by the geometry 
manager 
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Table B—16 (Cont.) Message Box Attributes 


Attribute C Name C Data Type 
Core Widget Attributes 

y DwtNy Position 

width DwtNwidth Dimension 
height DwtNheight Dimension 
border_width DwtNborderWidth Dimension 
border DwtNborder Pixel 
border_pixmap DwtNborderPixmap Pixmap | 
background DwiNbackground Pixel 
background_pixmap DwtNbackgroundPixmap Pixmap 
colormap DwtNcolormap Colormap 
sensitive DwtNsensitive Boolean 
ancestor_sensitive DwtNancestorSensitive Boolean 
accelerators DwtNaccelerators XtTranslations 
depth DwtNdepth int 
translations DwtNtranslations XtTranslations 
mapped_when_ DwtNmappedWhenManaged Boolean 
managed 

screen DwtNscreen Screen * 


destroy_callback 


DwtNdestroyCallback 


DwtCallibackPtr 


Default 


Determined by the geometry 
manager 


5 pixels 

5 pixels 

1 pixel 

Default foreground color 
Null 

Default background color 
Null 

Default color map 

True 


The bitwise AND of the 
parent widget’s sensitive 
and ancestor_sensitive 
attributes 


Null 
Depth of the parent window 
Null 
True 


The parent screen 
Null 





Dialog Box Pop-Up Aitributes 





foreground DwtNforeground Pixel 

highlight DwtNhighlight Pixel 
highlight_pixmap DwtNhighlightPixmap Pixmap 
user_data DwtNuserData Opaque * 
direction_r_to_| DwtNdirectionRToL Boolean 

font DwtNfont DwtFontList 
help_callback DwtNhelpCallback DwtCallbackPtr 
units DwtNunits unsigned char 
title DwiNtitle DwtCompString 
style DwiNstyle unsigned char 
map_callback DwtNmapCallback DwtCallbackPtr 


unmap_callback 
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DwtNunmapCallback 


DwtCallbackPtr 


Default foreground color 
Default foreground color 
Null 

Null 

Not supported 

XUI Toolkit font 

Null 

Not supported 

Widget name 

DwtModal 

Null 

Null 
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Attribute 


Summary of Widget Attributes (C Binding) 


C Name 


Dialog Box Pop-Up Attributes 


focus_caliback 


text_merge_ 
translations 


margin_width 
margin_height 
default_position 
child_overlap 
resize 
take_focus 


no_resize 
auto_unmanage 
default_button 
cancel_button 


DwtNfocusCallback 
DwiNtextMergeTranslations 


DwtNmarginWidth 
DwtNmarginHeight 
DwtNdefaultPosition 
DwtNchildOverlap 
DwitNresize 
DwtNtakeFocus 


DwtNnoResize 
DwtNautoUnmanage 
DwtNdefaultButton 
DwtNcancelButton 


Widget-Specific Attributes 

label DwtNlabel 
ok_label DwtNokLabel 
yes_callback DwtNyesCallback 


C Data Type 


DwtCallbackPtr 
XtTranslations 


Dimension 
Dimension 
Boolean 
Boolean 
unsigned char 
Boolean 


Boolean 
Boolean 
Widget 
Widget 


DwtCompSiring 
DwtCompSiring 


~DwtCallbackPtr 


B.16 Message Box 


Default 


Null 
Not supported 


12 pixels 

10 pixels 

False 

Not supported 
DwtShrinkWrap 


True for modal dialog box; 
false for modeless dialog 
box 


True 
True 
Not supported 
Not supported 


Widget name 
“Acknowledged” 
Null 





Option Menu 


See Table B-17 for a summary of option menu widget attributes. 


Table B-17 Option Menu Attributes 





Attribute C Name C Data Type Default 

Core Widget Attributes 

Xx DwtNx Position Determined by the geometry 
manager 

y DwtNy Position Determined by the geometry 
manager 

width DwtNwidth Dimension As large as necessary to 


hold all child widgets 
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Table B-17 (Cont.) Option Menu Attributes 


Attribute 


Core Widget Attributes 


height 


border_width 

border 
border_pixmap 
background 
background_pixmap 
colormap 

sensitive 
ancestor_sensitive 


accelerators 
depth 
translations 


mapped_when_ 
managed 


screen 
destroy_callback 


C Name 


DwtNheight 


DwtNborderWidth 
DwtNborder 
DwtNborderPixmap 
DwtNbackground 
DwtNbackgroundPixmap 
DwtNcolormap 
DwitNsensitive 
DwtNancestorSensitive 


DwtNaccelerators 
DwtNdepth 

DwtNtranslations 
DwtNmappedWhenManaged 


DwtNscreen 
DwtNdestroyCallback 


C Data Type 


Dimension 


Dimension 
Pixel 
Pixmap 
Pixel 
Pixmap 
Colormap 
Boolean 
Boolean 


XtTranslations 
int 
XtTranslations 
Boolean 


Screen * 
DwtCallbackPtr 


Default 


As large as necessary to 
hold all child widgets 


1 pixel 

Default foreground color 
Null 

Default background color 
Null 

Default color map 

True 


The bitwise AND of the 
parent widget’s sensitive 
and ancestor_sensitive 
attributes 


Null 
Depth of the parent window 
Null 
True 


The parent screen 
Null 





Common Widget Attributes 


foreground 
highlight 
highlight_pixmap 
user_data 
direction_r_to_| 
font 


help_callback 


Menu Attributes 


orientation 
spacing 
adjust_margin 
margin_width 


DwtNforeground 
DwtNhighlight 
DwtNhighlightPixmap 
DwtNuserData 
DwtNdirectionRToL 
DwtNfont 


DwtNhelpCallback 


DwtNorientation 
DwtNspacing 
DwtNadjustMargin 
DwtNmarginWidth 


Pixel 

Pixel 
Pixmap 
Opaque * 
Boolean 
DwtFontList 


DwtCallbackPtr 


unsigned char 
Dimension 
Boolean 
Dimension 


Default foreground color 
Default foreground color 
Null 

Null 

False 


Default XUI Toolkit font; 
used only by gadget children 


Null 


DwtOrientationVertical 
1 pixel 

True 

3 pixels 
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Table B-—17 (Cont.) 
Attribute 


Menu Attributes 


margin_height 
entry_border 
menu_alignment 
entry_alignment 
menu_packing 


menu_num_columns 
menu_radio 


radio_always_one 


menu_is _ 
homogeneous 


menu_entry_class 


menu_history 
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Option Menu Attributes 


C Name 


DwtNmarginHeight 
DwtNentryBorder 
DwtNmenuAlignment 
DwtNentryAlignment 
DwtNmenuPacking 


DwitNmenuNumColumns 
DwiNmenuRadio 


DwtNradioAlwaysOne 
DwtNmenulsHomogeneous 


DwiNmenuEntryClass 


DwtNmenuhistory 


C Data Type 


Dimension 
Dimension 
Boolean 
unsigned char 
unsigned char 


int 
Boolean 


Boolean 
Boolean 


WidgetClass 


Widget 


B.17 Option Menu 


Default 


3 pixels 

0 pixels 

True 
DwtAlignmentBeginning 


DwitMenuPackingTight for all 
menu types except for radio 
boxes. Radio boxes default 
to DwtMenuPackingColumn. 
1 column 


False except for radio boxes, 
which default to true 


True 


False except for radio boxes, 
which default to true 

Null except for radio 

boxes, which default to 
togglebuttonwidgetclass 


Null 





entry_callback DwtNentryCallback DwtCallbackPtr Null 
map_callback DwtNmapCallback DwtCallbackPtr Null 
unmap_callback DwtNunmapCallback DwtCallbackPtr Null 
menu_help_widget DwiNmenuHelpWidget Widget Null 
Widget-Specific Attributes 

label DwiNlabel DwtCompString Widget name 
sub_menu_id DwtNsubMenuld Widget Zero 

Pull Down Menu Entry 


See Table B-18 for a summary of pu 


attributes. 


li-down menu entry widget 
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Table B-18 Pull Down Menu Eniry Attributes 





Attribute C Name C Data Type Default 

Core Widget Attributes 

X DwtNx Position Determined by the geometry 
manager 

y DwtNy Position Determined by the geometry 
manager 

width DwtNwidth Dimension Width of the label or pixmap, 
plus the hotspot width, plus 
two times margin_width 

height DwtNheight Dimension Height of the label or 
pixmap, plus two times 
margin_height 

border_width DwtNborderWidth Dimension 0 pixels 

border DwtNborder Pixel Default foreground color 

border_pixmap DwtNborderPixmap Pixmap Null 

background DwtNbackground Pixel Default background color 

background_pixmap DwtNbackgroundPixmap Pixmap Null 

colormap DwiNcolormap Colormap Default color map 

sensitive DwtNsensitive Boolean True . 

ancestor_sensitive DwtNancestorSensitive Boolean The bitwise AND of the 
parent widget’s sensitive 
and ancestor_sensitive 
attributes 

accelerators DwtNaccelerators XtTranslations Null 

depth DwiNdepth int Depth of the parent window 

translations DwtNtranslations XtTranslations Null 

mapped_when_ DwtNmappedWhenManaged Boolean True 

managed 

screen DwtNscreen Screen * The parent screen 


destroy_callback 


DwtNdestroyCallback 


Common Widget Attributes 


foreground 
highlight 
highlight |_pixmap 
user_data 
direction_r_to_| 
font 
help_callback 
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DwtNforeground © 
DwtNhighlight 
DwtNhighlightPixmap 
DwitNuserData 
DwiNdirectionRToL 
DwtNfont 
DwtNhelpCallback 


DwitCallbackPtr 


_ Pixel 


Pixel 

Pixmap 
Opaque * 
Boolean 
DwtFonitList 
DwtCallbackPtr 


Null 


Default foreground color 
Default foreground color 
Null 

Null 

False 

XUI Toolkit font 

Null 


(continued on next page) 
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Table B-18 (Cont.) 
Attribute 


Label Attributes 


label_type 
label 
margin_width 


margin_height 


alignment 
pixmap 
margin_left 
margin_right 
margin_top 
margin_bottom 
conform_to_text 
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Pull Down Menu Entry Attributes 


C Name 


DwtNlabelType 
DwtNlabel 
DwtNmarginWidth 


DwtNmarginHeight 


DwtNalignment 
DwtNpixmap 
DwtNmarginLeft 
DwtNmarginRight 
DwiNmarginTop 
DwtNmarginBottom 
DwtNconformToText 


Widget-Specific Attributes 


sub_menu_id 
activate_callback 
pulling_callback 
hot_spot_pixmap 


Push Button 


DwiNsubMenuld 
DwtNactivateCallback 
DwtNpullingCaliback 
DwtNhotSpotPixmap 


C Data Type 


unsigned char 
DwtCompString 
Dimension 


Dimension 


unsigned char 
Pixmap 
Dimension 
Dimension 
Dimension 
Dimension 
Boolean 


Widget (*) 
DwtCailbackPtr 
DwtCallbackPtr 
Pixmap 


Default 


DwtCString 
Widget name 


2 pixels for text; 0 pixels for 
pixmap 


2 pixels for text; 0 pixels for 
pixmap 


DwtCenterAlignment 
Null 

0 pixels 

0 pixels 

0 pixels 

0 pixels 


True if width and height 
are zero; false if width and 
height are not zero 


Null 
Null 
Null 
Null 


See Table B-19 for a summary of push button widget attributes. 


Table B—19 Push Button Attributes 








Attribute C Name C Data Type Default 

Core Widget Attributes 

X DwtNx Position Determined by the geometry 
manager 

y DwtNy Position Determined by the geometry 
manager 

width DwtNwiadth Dimension Width of the label or pixmap, 


plus two times margin_ 
width 
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Table B—19 (Cont.) Push Button Attributes 


Attribute 


Core Widget Attributes 


height 


border_width 

border 
border_pixmap 
background 
background_pixmap 
colormap 

sensitive 
ancestor_sensitive 


accelerators 
depth 
translations 


mapped_when_ 
managed 


screen 
destroy_callback 


C Name 


DwtNheight 


DwiNborderWidth 
DwtNborder 
DwtNborderPixmap 
DwtNbackground 
DwtNbackgroundPixmap 
DwiNcolormap 
DwiNsensitive 
DwtNancestorSensitive 


DwtNaccelerators 
DwiNdepth 

DwiNtransiations 
DwtNmappedWhenManaged 


DwtNscreen 
DwtNdestroyCallback 


Common Widget Attributes 


foreground 
highlight 
highlight_pixmap 
user_data 
direction_r_to_| 
font 
help_callback 


Label Attributes 


label_type 
label 
margin_width 
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DwiNforeground 
DwtNhighlight 
DwtNhighlightPixmap 
DwtNuserData 
DwiNdirectionRToL 
DwtNfont 
DwtNhelpCallback 


DwiNlabelType 
DwiNlabel 
DwtNmarginWidth 


C Data Type 


Dimension 


Dimension 
Pixel 
Pixmap 
Pixel 
Pixmap 
Colormap 
Boolean 
Boolean 


XtTransiations 
int 
XtTranslations 
Boolean 


Screen * 
DwtCalibackPtr 


Pixel 

Pixel 

Pixmap 
Opaque * 
Boolean 
DwtFontList 
DwtCallbackPir 


unsigned char 
DwtCompString 
Dimension 


Default 


Height of the label or 
pixmap, plus two times 
margin_height 


1 pixel 

Default foreground color 
Null 

Default background color 
Null 

Default color map 

True 


The bitwise AND of the 
parent widget’s sensitive 
and ancestor_sensitive 
attributes 


Null 

Depth of the parent window 
Null 

True — 


The parent screen 
Null 


Default foreground color 
Default foreground color 
Null 

Null 

False 

XUI Toolkit font 

Null 


DwtCString 

Widget name 

2 pixels for text; 0 pixels for 
pixmap 
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Table B-19 (Cont.) Push Button Attributes 
Attribute C Name C Data Type Default 


Label Attributes 





margin_height DwtNmarginHeight Dimension 2 pixels for text; 0 pixels for 
pixmap 

alignment DwtNalignment unsigned char DwtCenterAlignment 

pixmap DwtNpixmap Pixmap Null 

margin_left DwtNmarginLeft Dimension 0 pixels 

margin_right DwtNmarginRight Dimension 0 pixels 

margin_top DwtNmarginTop Dimension 0 pixels 

margin_bottom DwtNmarginBottom Dimension 0 pixels 

conform_to_text DwtNconformToText Boolean True if width and height 


are zero; false if width and 
height are not zero 





Widget-Specific Attributes 





border_highlight DwitNborderHighlight Boolean False 
fill_highlight DwiNfillHighlight Boolean False 
activate_callback DwiNactivateCallback DwtCallbackPtr Null 
arm_callback DwtNarmCallback DwtCallbackPtr Null 
disarm_callback DwtNdisarmCallback DwtCallbackPtr Null 
accelerator_text DwtNacceleratorText DwtCompString Null 
button_accelerator DwtNbuittonAccelerator char * Null 
shadow DwtNshadow Boolean True 
Radio Box 


See Table B—20 for a summary of radio box widget attributes. 


Table B—-20 Radio Box Attributes 











Attribute C Name C Data Type Default 

Core Widget Attributes 

X DwitNx Position Determined by the geometry 
manager 

y : DwiNy Position Determined by the geometry 
manager 

width DwitNwidth Dimension - As large as necessary to 


hold all child widgets 
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B.20 Radio Box 


Table B-20 (Cont.) Radio Box Attributes 








destroy_callback 


DwtNdestroyCallback 


Common Widget Attributes 


foreground DwiNforeground 
highlight DwtNhighlight 
highlight_pixmap DwtNhighlightPixmap 
user_data DwtNuserData 
direction_r_to_| DwtNdirectionRToL 
font DwtNfont 
help_callback DwtNhelpCallback 


Widget-Specific Attributes 


orientation DwiNorientation 
spacing DwtNspacing 
adjust_margin DwtNadjustMargin 
margin_width 
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DwiNmarginWidth 


DwtCallbackPtr 


Pixel 

Pixel 

Pixmap 
Opaque * 
Boolean 
DwtFontList 
DwtCallbackPtr 


unsigned char 
Dimension 
Boolean 
Dimension 


Attribute C Name C Data Type Default 

Core Widget Attributes 

height DwtNheight Dimension As large as necessary to 
hold all child widgets 

border_width DwiNborderWidth Dimension 1 pixel 

border DwtNborder Pixel Default foreground color 

border_pixmap DwtNborderPixmap Pixmap Null 

background DwtNbackground Pixel Default background color 

background_pixmap DwtNbackgroundPixmap Pixmap Null 

colormap DwtNcolormap Colormap Default color map 

sensitive DwtNsensitive Boolean True 

ancestor_sensitive DwtNancestorSensitive Boolean The bitwise AND of the 
parent widget’s sensitive 
and ancestor_sensitive 
attributes 

accelerators DwtNaccelerators XtTranslations Null 

depth DwtNdepth int Depth of the parent window 

translations DwtNtranslations XtTranslations Null 

mapped_when_ DwitNmappedWhenManaged Boolean True 

managed 

screen DwiNscreen Screen * The parent screen 


Null 


Default foreground color 
Default foreground color 
Null 

Null 

False 

XUI Toolkit font 

Null 


DwtOrientation Vertical 
1 pixel 

True 

3 pixels 
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Table B—20 (Cont.) Radio Box Attributes 


B.20 Radio Box 





Attribute C Name C Data Type Default 
Widget-Specific Attributes 

margin_height DwtNmarginHeight Dimension 3 pixels 
entry_border DwtNentryBorder Dimension 0 pixels 
menu_alignment DwtNmenuAlignment Boolean True 


entry_alignment 
menu_packing 


menu_num_columns 
menu_radio 


radio_always_one 


menu_is_ 
homogeneous 


menu_entry_class 


menu_history 
entry_callback 
map_callback 
unmap_callback 
menu_help_widget 


DwtNentryAlignment 
DwtNmenuPacking 


DwitNmenuNumColumns 
DwtNmenuRadio 


DwtNradioAlwaysOne 
DwtNmenulsHomogeneous 


DwtNmenuEntryClass 


DwtNmenuhistory 
DwtNentryCallback 
DwtNmapCallback 
DwtNunmapCallback 
DwtNmenuHelpWidget 


unsigned char 
unsigned char 


int 
Boolean 


Boolean 
Boolean 


WidgetClass 


Widget 
DwtCallbackPtr 
DwtCallbackPtr 
DwtCallbackPtr 
Widget 


DwtrAlignmentBeginning 


DwtMenuPackingTight for all 
menu types except for radio 
boxes. Radio boxes default 
to DwtMenuPacking column. 


1 column 


False except for radio boxes, 
which default to true 


True 


False except for radio boxes, 
which default to true 


Null except for radio 
boxes, which default to 
togglebuttonwidgetclass 


Null 
Null 
Null 
Null 
Null 





Scale 


See Table B—21 for a summary of scale widget attributes. 


Table B—21 Scale Attributes 











Attribute C Name C Data Type Default 

Core Widget Attributes 

X DwtNx Position Determined by the geometry 
manager 

y DwtNy Position Determined by the geometry 


manager 
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B.21 Scale 


Table B—21 (Cont.) Scale Attributes 


Attribute 


Core Widget Attributes 


width 


height 


border_width 

border 
border_pixmap 
background 
background_pixmap 
colormap 

sensitive 
ancestor_sensitive 


accelerators 
depth 
translations 


mapped_when_ 
managed 


screen 
destroy_callback 


C Name 


DwtNwidth 


DwtNheight 


DwiNborderWidth 
DwtNborder 
DwitNborderPixmap 
DwtNbackground 
DwtNbackgroundPixmap 
DwtNcolormap 
DwtNsensitive 
DwtNancestorSensitive 


DwtNaccelerators 
DwtNdepth 

DwtNtranslations 
DwtNmappedWhenManaged 


DwiNscreen 
DwtNdestroyCallback 


Common Widget Attributes 


foreground 
highlight 
highlight_pixmap 
user_data 
direction_r_to_| 
font 
help_callback 
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DwtNforeground 
DwtNhighlight 
DwtNhighlightPixmap 
DwtNuserData 
DwtNdirectionRToL 
DwtNfont 
DwtNhelpCaliback 


C Data Type 


Dimenson 


Dimension 


Dimension 
Pixel 
Pixmap 
Pixel 
Pixmap 
Colormap 
Boolean 
Boolean 


XtTranslations 
int 
XtTranslations 
Boolean 


Screen * 
DwtCaillbackPtr 


Pixel 

Pixel 

Pixmap 
Opaque * 
Boolean 
DwtFontList 
DwtCallbackPtr 


Default 


Calculated based on the 
scale width or height, 
the label widths, and the 
orientation 


Calculated based on the 
scale width or height, 
the label widths, and the 
orientation 


0 pixels 

Default foreground color 
Null 

Default background color 
Null 

Default color map 

True 


The bitwise AND of the 
parent widget’s sensitive 
and ancestor_sensitive 
attributes 


Null 
Depth of the parent window 
Null 
True 


The parent screen 
Null 


Default foreground color 
Default foreground color 
Null 

Null 

False 

XUI Toolkit font 

Null 
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B.21 Scale 

Table B-21 (Cont.) Scale Attributes 

Attribute C Name C Data Type Default 

Widget-Specific Attributes 

value DwiNvalue int Zero 

title DwiNtitle DwtCompString DwtCString 

orientation DwiNorientation unsigned char DwtOrientationHorizontal 

scale_width DwiNscaleWidth Dimension 20 pixels for vertical scales; 
calculated for horizontal 
scales 

scale_height DwtNscaleHeight Dimension 20 pixels for horizontal 
scales; calculated for vertical 
scales 

min_value DwitNminValue int Zero 

max_value DwtNmaxValue int 100 

decimal_points DwtNdecimalPoints short Zero 

show_value DwtNshowValue Boolean True 

slider_pixmap DwtNsliderPixmap Pixmap Null 

drag_callback DwtNdragCallback DwitCallbackPtr Null 

value_changed_ DwiNvalueChangedCallback DwtCallbackPir Null 

callback 

Scroll Bar 


See Table B—22 for a summary of scroll bar widget attributes. 


Table B—22 Scroll Bar Attributes 


Attribute 


Core Widget Attributes 


X 


—< 


width 


height 


border_width 


C Name 


DwtNx 
DwtNy 


DwtNwidth 


DwtNheight 


DwtNborderWidth 


C Data Type 


Position 
Position 


Dimension 


Dimension 


Dimension 


Default 


Determined by the geometry 
manager 


Determined by the geometry 
manager 


For vertical scroll bars, 17 
pixels; for horizontal scroll 
bars, the width of the parent 
minus 17 pixels 


For horizontal scroll bars, 

17 pixels; for vertical scroll 
bars, the height of the parent 
minus 17 pixels 


1 pixel 
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B.22 Scroll Bar 


Table B-22 (Cont.) Scroll Bar Attributes 
Attribute C Name 


Core Widget Attributes 


border DwtNborder 
border_pixmap DwtNborderPixmap 
background DwtNbackground 
background_pixmap DwiNbackgroundPixmap 
colormap DwtNcolormap 

sensitive DwitNsensitive 
ancestor_sensitive DwtNancestorSensitive 
accelerators DwtNaccelerators 

depth DwtNdepth 

translations DwtNtranslations 
mapped_when_ DwtNmappedWhenManaged 
managed 

screen DwiNscreen 


destroy_callback DwtNdestroyCallback 


Common Widget Attributes 


foreground DwtNforeground 
highlight DwitNhighlight 
highlight_pixmap DwtNhighlightPixmap 
user_data DwitNuserData 
direction_r_to_| DwtNdirectionRToL 


font DwtNfont 


help_callback DwiNhelpCaliback 


C Data Type 


Pixel 
Pixmap 
Pixel 
Pixmap 
Colormap 
Boolean 
Boolean 


XtTranslations 
int 
XtTranslations 
Boolean 


Screen * 
DwtCailbackPtr 


Pixel 

Pixel 

Pixmap 
Opaque * 
Boolean 
DwiFonitList 
DwtCalibackPtr 


Default 


Default foreground color 
Null 

Default background color 
Null 

Default color map 

True 


The bitwise AND of the 
parent widget’s sensitive 
and ancestor_sensitive 
attributes 


Null 
Depth of the parent window 
Null 
True 


The parent screen 
Null 


Default foreground color 
Default foreground color 
Null 

Null 

False 

Not supported 

Null 


Widget-Specific Attributes . 
int_value Dwin(ifue e valué int Zero 


min_value DwiNminValue 
max_value DwtNmaxValue 
orientation DwtNorientation 
translations DwtNtranslations1 
translations2 DwtNtranslations2 
shown DwtNshown 
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int 
int 
unsigned char 
XtTranslations 
XtTransiations 
int 


Zero 

as Ve creal 
DwtOrientation@ter#ental. 
Null 

Null 

10 units 
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Table B-22 (Cont.) Scroll Bar Attributes 


Attribute C Name 
Widget-Specific Attributes 

inc DwtNinc 
page_inc DwitNpagelnc 


unit_inc_callback 
unit_dec_callback 
page_inc_calloback 
page_dec_callback 
to_top_callback 
to_bottom_callback 
drag_callback 


value_changed_ 
callback 


DwtNunitIncCallback 
DwtNunitDecCaliback 
DwtNpagelncCallback 
DwtNpageDecCallback 
DwtNto TopCallback 
DwitNtoBottomCallback 
DwtNdragCallback 
DwtNvalueChangedCallback 


C Data Type 


int 

int 

DwtCallbackPtr 
DwtCallbackPir 
DwtCallbackPtr 
DwtCallbackPtr 
DwtCallbackPtr 
DwtCallbackPir 
DwtCallbackPtr 
DwtCallbackPtr 


B.22 Scroll Bar 


Default 


10 units 
10 units 
Null 
Null 
Nuil 
Null 
Null 
Null 
Null 
Null 





Scroll Window 


See Table B—23 for a summary of scroll window widget attributes. 


Table B-23 Scroll Window Attributes 


Attribute 


Core Widget Attributes 


X 


¥ 


width 

height 

border_width 

border 
border_pixmap 
background 
background_pixmap 
colormap 

sensitive 
ancestor_sensitive 


C Name 


DwtNx 
DwiNy 


DwtNwidth 

DwtNheight 
DwtNborderWidth 
DwtNborder 
DwiNborderPixmap 
DwtNbackground 
DwtNbackgroundPixmap 
DwtNcolormap 
DwiNsensitive 
DwtNancestorSensitive 


C Data Type 


Position 
Position 


Dimension 
Dimension 
Dimension 
Pixel 
Pixmap 
Pixel 
Pixmap 
Colormap 
Boolean 
Boolean 


Default 


Determined by the geometry 
manager 


Determined by the geometry 
manager 


Widget specific 

Widget specific 

1 pixel 

Default foreground color 
Null 

Default background color 
Null | 

Default color map 

True 


The bitwise AND of the 
parent widget’s sensitive 
and ancestor_sensitive 
attributes 
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Table B-23 (Cont.) Scroll Window Attributes 
Attribute C Name C Data Type Default 


Core Widget Attributes 





accelerators DwtNaccelerators XtTranslations Null 

depth DwiNdepth int Depth of the parent window 
translations DwitNtranslations XtTranslations Null 

mapped_when_ DwtNmappedWhenManaged Boolean True 

managed 

screen DwitNscreen Screen * The parent screen 
destroy_callback DwtNdestroyCallback DwtCallbackPtr Null 


Common Widget Atiributes 





foreground DwtNforeground Pixel Default foreground color 
highlight DwtNhighlight Pixel Default foreground color 
highlight_pixmap DwtNhighlightPixmap Pixmap Null 

user_data DwtNuserData Opaque * Null 

direction_r_to_| DwiNdirectionRToL Boolean False 

font DwtNfont DwtFontList Not supported 
help_callback DwtNhelpCallback DwtCallbackPtr Not supported 





Widget-Specific Attributes 





h_scroll DwtNhorizontalScrollBar Widget Null 
v_scroll DwtNverticalScrollBar Widget Null 
work_window DwtNworkWindow Widget Null 
shown_value_ DwtNshownValueAutomaticHoriz Boolean True 


automatic_horiz 


shown_value__ DwtNshownValueAutomaticVert Boolean True 
automatic_vert 








Selection 


See Table B-24 for a summary of selection widget attributes. 
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Table B-24 Selection Attributes 


B.24 Selection 








Attribute C Name C Data Type Default 

Core Widget Attributes 

X DwtNx Position Centered in the parent 
window 

y DwtNy Position Centered in the parent 
window 

width DwtNwidth Dimension Width of the list box, plus the 
width of the push buttons, 
plus three times margin_ 
width 

height DwtNheight Dimension Height of the list box, plus 
the height of the text edit 
field, plus the height of 
the label, plus three times 
margin_height 

border_width DwtNborderWidth Dimension 1 pixel 

border DwtNborder Pixel Default foreground color 

border_pixmap DwtNborderPixmap Pixmap Null 

background DwtNbackground Pixel Default background color 

background_pixmap DwtNbackgroundPixmap Pixmap Null ° 

colormap DwtNcolormap Colormap Default color map 

sensitive DwiNsensitive Boolean True 

ancestor_sensitive DwtNancestorSensitive Boolean The bitwise AND of the 
parent widget’s sensitive 
and ancestor_sensitive 
attributes 

accelerators DwtNaccelerators XtTranslations Null 

depth DwtNdepth int Depth of the parent window 

translations DwiNtranslations XtTranslations Null 

mapped_when_ DwtNmappedWhenManaged Boolean True 

managed 

screen DwitNscreen Screen * The parent screen 


destroy_callback 


DwtNdestroyCallback 


DwitCallbackPtr 


Null 





Dialog Box Popup Attributes 





foreground 
highlight 
highlight_pixmap 
user_data 
direction_r_to_| 


DwtNforeground 
DwiNhighlight 
DwtNhighlightPixmap 
DwtNuserData 
DwtNdirectionRToL 


Pixel 
Pixel 
Pixmap 
Opaque * 
Boolean 


Default foreground color 
Default foreground color 
Null 

Null 

False 
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B.24 Selection 


Table B-24 (Cont.) Selection Attributes 





Attribute C Name C Data Type Default 

Dialog Box Popup Attributes 

font. DwtNfont DwtFoniList XUI Toolkit font 
help_callback DwtNhelpCallback DwtCallbackPtr Null 

units DwtNunits unsigned char DwtFontUnits 
style DwtNstyle unsigned char DwiModeless 
focus_callback DwtNfocusCallback DwtCallbackPitr Null 
text_merge_ DwtNtextMergeTranslations XtTranslations Null 

translations 

margin_width DwtNmarginWidth Dimension 5 pixels 
margin_height DwtNmarginHeight Dimension 5 pixels 
default_position DwitNdefaultPosition Boolean False 
child_overlap DwtNchildOverlap Boolean True 

resize DwiNresize unsigned char DwtResizeGrowOnly 
no_resize DwtNnoResize Boolean True | 
title DwiNtitle DwtCompString “Open” 
map_callback DwitNmapCallback DwtCallbackPtr Null 
unmap_callback DwtNunmapCallback DwtCallbackPtr Null 


take_focus 


auto_unmanage 
default_button 
cancel_button 


DwtNtakeFocus 


DwtNautoUnmanage 
DwtNdefaultBuiton 
DwtNcancelButton 


Widget-Specific Attributes 


label 

value 
selection_label 
ok_label 
cancel_label 
activate_callback 
cancel_callback 
no_match_callback 
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DwtNiabel 

DwtNvalue 
DwtNselectionLabel 
DwtNokLabel 
DwtNcancelLabel 
DwtNactivateCallback 
DwitNcancelCallback 
DwtNnoMatchCallback 


Boolean 


Boolean 
Widget 
Widget 


DwtCompString 
DwtCompString 
DwtCompString 
DwtCompString 
DwtCompString 
DwtCallbackPtr 
DwtCallbackPtr 
DwtCallbackPtr 


True for modal dialog box; 
false for modeless dialog 
box 


True 
Null 
Null 


“Items” 
Null string 
“Selection” 
“OK” 
“Cancel” 
Null 

Null 

Null 
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Table B-24 (Cont.) Selection Attributes 


B.24 Selection 





Attribute C Name C Data Type Default 
Widget-Specific Attributes 

visible_item_count DwtNvisibleltemsCount int 8 items 
items DwtNitems DwtCompString * Null 
item_count DwtNitemsCount int 0 items 
must_match DwtNmustMatch Boolean False 
Separator 


See Table B—25 for a summary of separator widget attributes. 


Table B-25 Separator Attributes 





Attribute C Name C Data Type Default 

Core Widget Attributes 

X DwtNx Position Determined by the geometry 
manager 

y DwiNy Position Determined by the geometry 
manager 

width DwtNwidth Dimension 3 pixels 

height DwtNheight Dimension 3 pixels 

border_width DwtNborderWidth Dimension 0 pixels 

border DwtNborder Pixel Default foreground color 

border_pixmap DwtNborderPixmap Pixmap Null 

background DwtNbackground Pixel Default background color 

background_pixmap DwtNbackgroundPixmap Pixmap Null 

colormap DwtNcolormap Colormap Default color map 

sensitive DwiNsensitive Boolean True 

ancestor_sensitive DwtNancestorSensitive Boolean The bitwise AND of the 
parent widget’s sensitive 
and ancestor_sensitive 
attributes 

accelerators DwtNaccelerators XtTranslations Null 

depth DwtNdepth int Depth of the parent window 

translations DwtNtranslations XtTranslations Not supported 

mapped_when_ DwiNmappedWhenManaged Boolean True 

managed 

screen DwiNscreen Screen * The parent screen 


desiroy_callback 


DwiNdestroyCallback 


DwtCallbackPtr 


Null 
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B.25 Separator 


Table B—25 (Cont.) Separator Attributes 


Attribute 


C Name 


Common Widget Attributes 


foreground 
highlight 
highlight_pixmap 
user_data 
direction_r_to_| 
font 
help_callback 


Label Attributes 


label_type 
label 
margin_width 


margin_height 


alignment 
pixmap 
margin_left 
margin_right 
margin_top 
margin_bottom 
conform_to_text 


DwtNforeground 
DwtNhighlight 
DwtNhighlightPixmap 
DwtNuserData 
DwtNdirectionRToL 
DwtNfont 
DwtNhelpCallback 


DwtNlabelType 
DwiNlabel 
DwiNmarginWidth 


DwtNmarginHeight 


DwtNalignment 
DwtNpixmap 
DwtNmarginLeft 
DwtNmarginRight 
DwtNmarginTop 
DwtNmarginBottom 
DwtNconformToText 


Widget-Specific Attributes 


C Data Type 


Pixel 

Pixel 

Pixmap 
Opaque * 
Boolean 
DwtFontList 
DwtCallbackPtr 


unsigned char 
DwtCompString 
Dimension 


Dimension 


unsigned char 
Pixmap 
Dimension 
Dimension 
Dimension 
Dimension 
Boolean 


Default 


Default foreground color 
Default foreground color 
Null 

Null 

False 

Not supported 

Not supported 


DwtCString 
Widget name 


2 pixels for text; 0 pixels for 
pixmap 


2 pixels for text; 0 pixels for 
pixmap 


DwtCenterAlignment 
Null 

0 pixels 

0 pixels 

0 pixels 

0 pixels 


True if width and height 
are zero; false if width and 
height are not zero 





orientation 


DwtNorientation 


unsigned char 


DwtOrientationHorizontal 








S Text 


See Table B—26 for a summary of simple text widget attributes. 
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Table B-26 S Text Attributes 


B.26 S Text 





Attribute C Name C Data Type Default 

Core Widget Attributes 

X DwtNx Position Determined by the geometry 
manager 

y DwtNy Position Determined by the geometry 
manager 

width DwtNwidth Dimension As large as necessary to 
display the rows and cols 
with the given margin_width 
and margin_height 

height DwtNheight Dimension As large as necessary to 
display the rows and cols 
with the given margin_width 
and margin_height 

border_width DwtNborderWidth Dimension 1 pixel 

border DwtNborder Pixel Default foreground color 

border_pixmap DwitNborderPixmap Pixmap Null 

background DwtNbackground Pixel Default background color 

background_pixmap DwtNbackgroundPixmap Pixmap Null 

colormap > DwtNcolormap Colormap Default color map 

sensitive DwtNsensitive Boolean True 

ancestor_sensitive DwtNancestorSensitive Boolean The bitwise AND of the 
parent widget’s sensitive 
and ancestor_sensitive 
attributes 

accelerators DwtNaccelerators XtTranslations Null 

depth DwitNdepth int Depth of the parent window 

translations DwiNiranslations XtTranslations Null 

mapped_when_. DwtNmappedWhenManaged Boolean True 

managed 

screen DwtNscreen Screen * The parent screen 

destroy_callback DwiNdestroyCallback DwtCallbackPtr Null 

Widget-Specific Attributes 

margin_width DwtNmarginWidth Dimension 2 pixels 

margin_height DwtNmarginHeight Dimension 2 pixels 

cols DwtNcols Dimension 20 characters 

rows DwtNrows Dimension 1 character 

top_position DwtNtopPosition long int Zero 

word_wrap DwtNwordWrap Boolean False 
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B.26 S Text 


Table B-26 (Cont.) S Text Attributes 


Attribute 


C Name 


Widget-Specific Attributes 


scroll_vertical 
resize_height 
resize_width 

value 

editable 
max_length 
focus_cailback 
help_callback 
lost_focus_callback 


value_changed_ 
callback 


insertion_point_visible 


auto_show_insert_ 
point 


insertion_position 
foreground 

font 

blink_rate 
scroll_left_side 
half_border 
pending_delete 


Toggle Button 


DwtNscrollVertical 
DwtNresizeHeight 
DwtNresizeWidth 

DwtNvalue 

DwtNeditable 
DwtNmaxLength 
DwtNfocusCallback 
DwtNhelpCallback 
DwitNlostFocusCallback 
DwtNvalueChangedCallback 


DwtNinsertionPointVisible 
DwtNautoShowinsertPoint 


DwtNinsertionPosition 
DwtNforeground 
DwtNfont 
DwiNblinkRate 
DwtNscrollLeftSide 
DwiNhalfBorder 
DwtNpendingDelete 


C Data Type 


Boolean 
Boolean 
Boolean 

char * - 
Boolean 

int 
DwtCalibackPtr 
DwtCailbackPtr 
DwtCallbackPtr 
DwtCallbackPtr 


Boolean 
Boolean 


int 

Pixel 
FontList 
int 
Boolean 
Boolean 
Boolean 


Default 


False 

True 

True 

Null string (" ") 
True 

931 —1 

Null 

Null 

Null 

Null 


True 
True 


Zero 

Default foreground color 
Current server DwtFontList 
500 milliseconds 

False 

True 

True 


See Table B—27 for a summary of toggle button widget attributes. 


Table B-27 Toggle Button Attributes 





Attribute C Name C Data Type Default 

Core Widget Attributes 

x DwitNx Position Determined by the geometry 
manager 

y DwitNy Position Determined by the geometry 
manager 

width DwitNwidth Dimension Width of the label or pixmap, 


plus two times margin_ 
width 
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Table B-27 (Cont.) Toggle Button Attributes 


Attribute 


C Name 


Core Widget Attributes 


height 


border_width 

border 
border_pixmap 
background 
background_pixmap 
colormap 

sensitive 
ancestor_sensitive 


accelerators 
depth 
translations 


mapped_when_ 
managed 


screen 
destroy_callback 


DwtNheight 


DwtNborderWidth 
DwtNborder 
DwtNborderPixmap 
DwtNbackground 
DwtNbackgroundPixmap 
DwtNcolormap 
DwtNsensitive 
DwtNancestorSensitive 


DwtNaccelerators 
DwtNdepth 

DwiNtranslations 
DwtNmappedWhenManaged 


DwtNscreen 


| DwitNdestroyCallback 


Common Widget Attributes 


C Data Type 


Dimension 


Dimension 
Pixel 
Pixmap 
Pixel 
Pixmap 
Colormap 
Boolean 
Boolean 


XiTranslations 
int 
XtTranslations 
Boolean 


Screen * 
DwtCailbackPtr 


B.27 Toggle Button 


Default 


Height of the label or 
pixmap, plus two times 


_ margin_height 


0 pixels 

Default foreground color 
Null 

Default background color 
Null 

Default color map 

True 


The bitwise AND of the 
parent widget’s sensitive 
and ancestor_sensitive 
attributes 


Null 
Depth of the parent window 
Null 
True 


The parent screen 
Null 





foreground DwtNforeground Pixel Default foreground color 
highlight DwtNhighlight Pixel Default foreground color 
highlight_pixmap DwiNhighlightPixmap Pixmap Null | 
user_data DwtNuserData Opaque * Null 

direction_r_to_| DwtNdirectionRToL | Boolean False 

font DwtNfont DwtFontList XUI Toolkit font 
help_callback DwtNhelpCallback DwtCallbackPir Null 

Label Attributes 

label_type DwitNlabelType unsigned char DwtCString 

label DwtNlabel DwtCompString Widget name 
margin_width DwtNmarginWidth Dimension 2 pixels for text; 0 pixels for 


pixmap 
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B.27 Toggle Button 


Table B-27 (Cont.) Toggle Button Attributes 


Attribute 


. Label Attributes 


margin_height 


alignment 
pixmap 
margin_left 
margin_right 
margin_top 
margin_bottom 
conform_to_text 


C Name 


DwtNmarginHeight 


DwtNalignment 
DwtNpixmap 
DwtNmarginLeft 
DwtNmarginRight 
DwtNmarginTop 
DwtNmarginBottom 
DwtNconformToText 


Widget-Specific Attributes 


shape 
visible_when_off 
spacing 
pixmap_on 
pixmap_off 
value 
arm_callback 
disarm_callback 


value_changed_ 
callback 


indicator 


accelerator_text 


button_accelerator 


DwtNshape 
DwtNvisibleWhenOff 
DwtNspacing 
DwtNpixmapOn 
DwtNpixmapOff 

DwitNvalue 
DwtNarmCallback 
DwtNdisarmCallback 
DwtNvalueChangedCallback 


DwiNindicator 


DwtNacceleratorText 
DwtNbuttonAccelerator 


C. Data Type 


Dimension 


unsigned char 
Pixmap 
Dimension 
Dimension 
Dimension 
Dimension 
Boolean 


unsigned char 
Boolean 

short 

Pixmap 
Pixmap 
Boolean 
DwtCallbackPtr 
DwtCallbackPtr 
DwtCallbackPtr 


Boolean 


DwtCompString 
char * 


Default 


2 pixels for text; 0 pixels for 
pixmap 


DwtCenterAlignment 
Null 

0 pixels 

0 pixels 

0 pixels 

0 pixels 


True if width and height 
are zero; false if width and 
height are not zero 


DwtRectangular 
True 

4 pixels 

Null 

Null 

False 

Null 

Null 

Null 


True when label is text; false 
when label is pixmap 


Null 
Null 





Window 
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See Table B—28 for a summary of window widget attributes. 


Summary of Widget Attributes (C Binding) 


Table B—-28 Window Attributes 


Attribute 


Core Widget Attributes 


X 


y 


width 

height 

border_width 

border 
border_pixmap 
background 
background_pixmap 
colormap 

sensitive 
ancestor_sensitive 


accelerators 
depth 
translations 


mapped_when_ 
managed 


screen 
destroy_cailback 


C Name 


DwtNx 
DwtNy 


DwtNwidth 

DwtNheight 
DwiNborderWidth 
DwtNborder 
DwtNborderPixmap 
DwitNbackground 
DwtNbackgroundPixmap 
DwtNcolormap 
DwtNsensitive 
DwtNancestorSensitive 


DwiNaccelerators 
DwtNdepth 

DwiNiranslations _ 
DwiNmappedWhenManaged 


DwiNscreen 
DwtNdesiroyCailback 


Common Widget Attributes 


foreground 
highlight 
highlight_pixmap 
user_data 
direction_r_to_| 
font 
help_callback 


DwiNforeground 
DwtNhighlight 
DwtNhighlightPixmap 
DwtNuserData 
DwtNdirectionRToL 
DwtNfont 
DwtNhelpCallback 


Widget-Specific Attribute 


expose_callback 


DwtNexposeCallback 


C Data Type 


Position 
Position 


Dimension 
Dimension 
Dimension 
Pixel 
Pixmap 
Pixel 
Pixmap 
Colormap 
Boolean 
Boolean 


XiTranslations 
int 


_ XtTranslations 


Boolean 


Screen * 
DwtCallbackPtr 


Pixel 

Pixel 

Pixmap 
Opaque * 
Boolean 
DwtFontList 
DwtCallbackPtr 


DwtCallbackPtr 


B.28 Window 


Default | 


Determined by the geometry 
manager 


Determined by the geometry 
manager 


0 pixels 

0 pixels 

1 pixel 

Default foreground color 
Null 

Default background color 
Null 

Default color map 

True 


The bitwise AND of the 
parent widget’s sensitive 
and ancestor_sensitive 
attributes 


Null 
Depth of the parent window 
Nuil 
True 


The parent screen 
Null 


Default foreground color 
Default foreground color 
Null 

Null 

False 

Not supported 

Not supported 


Null 
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B.29 Work Box 





Work Box 


See Table B—29 for a summary of work box widget attributes. 


Table B—29 Work Box Attributes 





Attribute C Name C Data Type Default 

Core Widget Attributes 

X DwtNx Position Determined by the geometry 
manager 

y DwiNy Position Determined by the geometry 
manager 

width DwtNwidth Dimension 5 pixels 

height DwtNheight Dimension 5 pixels 

border_width DwtNborderWidth Dimension 1 pixel 

border DwtNborder Pixel Default foreground color 

border_pixmap DwtNborderPixmap Pixmap Null 

background DwtNbackground Pixel Default background color 

background_pixmap DwtNbackgroundPixmap Pixmap Null 

colormap DwtNcolormap Colormap Default color map 

sensitive DwtNsensitive Boolean True 

ancestor_sensitive DwtNancestorSensitive Boolean The bitwise AND of the 
parent widget’s sensitive 
and ancestor_sensitive 
attributes 

accelerators DwtNaccelerators XtTranslations Null 

depth DwtNdepth int Depth of the parent window 

translations DwtNtransiations XtTranslations Null 

mapped_when_ DwtNmappedWhenManaged Boolean True 

managed 

screen DwtNscreen Screen * The parent screen 


destroy_callback 
destroy_callback 


DwtNdestroyCallback 
DwtNdestroyCallback 


DwtCallbackPtr 
DwtCallibackPtr 


Null 
Null 





Dialog Box Pop-Up Attributes 





foreground 
highlight 
highlight_pixmap 
user_data 
direction_r_to_| 
font 


DwiNforeground 
DwtNhighlight 
DwtNhighlightPixmap 
DwtNuserData 
DwtNdirectionRToL 
DwiNfont 


Pixel 

Pixel 
Pixmap 
Opaque * 
Boolean 
DwtFontList 


Default foreground color 
Default foreground color 
Null 

Null 

Not supported 

XUI Toolkit font 





(continued on next page) 
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Table B—29 (Cont.) Work Box Attributes 


Attribute 


C Name 


Dialog Box Pop-Up Attributes 


help_callback 
units 

title 

style 
map_cailback 
unmap_callback 
focus_callback 


text_merge_ 
translations 


margin_width 
margin_height 
default_position 
child_overlap 
resize 
take_focus 


no_resize 
auto_unmanage 
default_button 
cancel_button 


DwtNhelpCallback 
DwtNunits 

DwiNtitle 

DwtNstyle 
DwiNmapCallback 
DwtNunmapCallback 
DwtNfocusCallback 
DwiNtextMerge Translations 


DwiNmarginWidth 
DwtNmarginHeight 
DwtNdefaultPosition 
DwtNchildOverlap 
DwtNresize 
DwiNtakeFocus 


DwtNnoResize 
DwtNautoUnmanage 
DwtNdefaultButton 
DwtNcancelButton 


Widget-Specific Attributes 


label 
cancel_label 
cancel_callback 


DwiNiabel 
DwtNcancelLabel 
DwtNcancelCallback 


C Data Type 


DwtCallbackPir 
unsigned char 
DwitCompString 
unsigned char 
DwtCallbackPtr 
DwtCallbackPtr 
DwtCallbackPtr 
XtTranslations 


Dimension 
Dimension 
Boolean 
Boolean 
unsigned char 
Boolean 


Boolean 
Boolean 
Widget 
Widget 


DwtCompString 
DwtCompsString 
DwtCallbackPtr 
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Default 


Null 

Not supported 
Widget name 
DwtModal 

Null 

Null 

Null 

Not supported 


12 pixels 

10 pixels 

False 

Not supported 
DwtResizeShrinkWrap 


True for modal dialog box; 
false for modeless dialog 
box 


True 
True 
Not supported 
Not supported 


Widget name 
“Cancel” 
Null 
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A 


Accelerators 
installing * 2-131, 2-132 
parsing table» 2-171 
Accept focus procedure» 2-55 
Access 
types of* 1-5 
Access column 
in VAX formats 1-5 
Actions 
adding * 2-23 
Action table * 2-23 
ADD ACTIONS routine * 2-23 
ADD CALLBACK routine * 2-24 
ADD CALLBACKS routine» 2-25 
ADD CONVERTER routine» 2-26 
ADD EVENT HANDLER routine + 2-28 
ADD EXPOSURE TO REGION routine « 2-30 
ADD FONT LIST routine + 5-3 
ADD GRAB routine 2-31 
Adding entry to list box widget» 7-32 
ADD INPUT routine» 2-33 
ADD RAW EVENT HANDLER routine + 2-35 
ADD TIMEOUT routine» 2-37 
ADD WORK PROC routine * 2-38 
See also APPLICATION ADD WORK PROC 
routine 
Allocation 
freeing memory « 2-98 
of an array* 2-62 
Append command line» 7-11 
Application 
adding work procedure * 2—43 
creating shell widget» 2—45 
creating timeout» 2-41 
looking for pending events * 2-50 
processing events * 2-51 
processing input» 2—47 
registering new event» 2-39 
returning input value» 2-48, 2-49 
APPLICATION ADD INPUT routine * 2-39 
APPLICATION ADD TIME OUT routine» 2-41 
APPLICATION ADD WORK PROC routine» 2-43 
Application context 
closing and removing a display * 2-65 


Application context (cont’d.) 
creating * 2-71 
destroying * 2-83 
initializing and adding a display * 2-93 
returning * 2~232 
APPLICATION CREATE SHELL routine * 2-45 
APPLICATION MAIN LOOP routine * 2-47 
APPLICATION NEXT EVENT routine 2-48 
APPLICATION PEEK EVENT routine * 2-49 
APPLICATION PENDING routine * 2-50 
APPLICATION PROCESS EVENT routine» 2-51 
Application resources 
retrieving * 2-99 
Application widget 
creating * 2-72 
Argument 
settings 3-13 
setting a callback» 3—14 
setting a descriptor 3-15 
Argument information section 
of routine format* 1-7 
Argument list 
merging more than ones 2-148 
setting values * 2-202 
Arguments sections 1-3 
Array 
allocating and initializing » 2-62 
determining number of elements « 2—155 
ATTACHED DIALOG BOX CREATE routine» 8-11 
ATTACHED DIALOG BOX POPUP CREATE routine « 
8-21 
Attached dialog box pop-up widget 
creating with low-level routine * 8-21 
summary of attributes > A-3 
ATTACHED DIALOG BOX routine» 7-5 
Attached dialog box widget 
creating with high-level routine * 7—5 
creating with low-level routine » 8—11 
summary of attributes * A-1, B—1 
Attribute exception section 
of routine formats 1-7 
Attribute information section 
of routine format+ 1—7 
Attributes 
of attached dialog box pop-up widget» A-3 
of attached dialog box widget» A-1, B—1 
of caution box widget» A-—5, B-5 
of command window widget+ A~-7, B—7 


iiGex—1i 


index 


Attributes (cont’d.) 

of dialog box pop-up widget» A-11, B—10 

of dialog box widget * A-9, B-3, B-9 

of file selection widget» A-12, B—-12 

of help widget» A-15, B-15 

of label widget» A-18, B—-18 

of list box widget «: A-20, B-20 

of main window widgets A-22, B-22 

of menu bar widget» A-24, B—23 

of menu pop-up widget + A-28, B-28 

of menu pull-down widget» A-30, B—29 

of menu widget» A-26, B—25 

of message box widget * A-32, B-31 

of option menu widget» A-34, B-33 

of pull-down menu entry widget» A-37, B-35 

of push button widget » A-39, B-37 

of radio box widget» A-41, B-39 

of scale widget» A-43, B—41 

of scroll bar widget» A-45, B—43 

of scroll window widget» A-47, B-45 

of selection widget» A—49, B—46 

of separator widget» A-51, B—49 

of simple text widget * A-53, B-50 

of toggle button widget» A-55, B-52 

of window widget» A-—57, B—54 

of work box widget * A-59, B-56 
AUGMENT TRANSLATIONS routine + 2-53 


BEGIN COPY TO CLIPBOARD routine» 6-4 
Box 
See ATTACHED DIALOG BOX CREATE routine 
See ATTACHED DIALOG BOX POPUP CREATE 
routine 
See ATTACHED DIALOG BOX routine 
See CAUTION BOX CREATE routine 
See CAUTION BOX routine 
See DIALOG BOX CREATE routine 
See DIALOG BOX POPUP CREATE routine 
See DIALOG BOX routine 
See LIST BOX CREATE routine 
See LIST BOX routine 
See MESSAGE BOX CREATE routine 
See MESSAGE BOX routine 
See WORK BOX CREATE routine 
See WORK BOX routine 
BUILD EVENT MASK routine» 2-54 
Button 
See PUSH BUTTON CREATE routine 
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Button (cont’d.) 
See TOGGLE BUTTON CREATE routine 


C 


CALL ACCEPT FOCUS routine + 2-55 
Callback data structure section 

of routine formats 1-7 
CALLBACK EXCLUSIVE routine *» 2-57 
Callback field descriptions section 

of routine format* 1-7 
CALLBACK NONE routine * 2-58 
CALLBACK NONEXCLUSIVE routine * 2—59 
CALLBACK POPDOWN routine» 2-60 
Callback procedure 

adding to a list» 2-24, 2-25 

removing from a callback list» 2-186, 2-187, 

2-189 

Callback reasons section 

of routine format* 1—7 
Callback routine 

adding to a list» 2-24, 2-25 

determining status * 2—128 

executing * 2-56 

mapping a pop-up * 2-57, 2-58, 2-59 
Callback routines * 8—9 
Callback structure 

names * 8-10 

standard s+ 8-9 
CALL CALLBACKS routine * 2—56 
CALLOC routine » 2-62 








‘CANCEL COPY FORMAT routine * 6—7 


CANCEL COPY TO CLIPBOARD routine * 6-9 
Case converter 
calling * 2-70 
registering * 2-184 
CAUTION BOX CREATE routine» 8-24 
CAUTION BOX routine + 7-8 
Caution box widget 
creating with high-level routine» 7-8 
creating with low-level routine * 8-24 
summary of attributes > A-5, B—5 
Character set identifier 
definition of» 5—1 
CHECK SUBCLASS routine» 2-63 
Children 
management 2-145, 2-225 
removing list of * 2-225 
CHILDREN routine» 3-2 


Child widget 

adding a single» 2-144 

managements 2-144, 2-224 

removing a singles 2-224 

resizing window « 2-200 

writing new coordinates * 2-150 
Class 

See also Subclass 

See also Superclass 

determining widget» 2-64 
Classes 

See Widget classes 
CLASS routine» 2-64 
Clearing a global selection 

in a simple text widget + 7-91 
Clipboard 

beginning copy tos 6-4 

canceling copy format + 6—7 

canceling copy to» 6—9 

copying from* 6-15 

copying tos 6-18 

ending copy to» 6-21 

locking access to* 6-11 

next-paste counts 6-23 

next-paste format» 6-25 

next-paste length» 6-27 

passing data tos 6-2 

recopying to* 6-31 

undo copy to* 6-33 

unlocking access to* 6-13 
CLIPBOARD LOCK routine» 6-11 
CLIPBOARD UNLOCK routine + 6-13 
CLOSE DISPLAY routine > 2-65 
CLOSE HIERARCHY routine» 4-3 
COMMAND APPEND routine + 7-11 


COMMAND ERROR MESSAGE routine» 7-12 - 


COMMAND SET routine» 7-13 
Command window 

adding to main window + 7—46 
COMMAND WINDOW CREATE routine» 8-30 
COMMAND WINDOW routine + 7-14 
command window widget 

summary of attributes » B—7 
Command window widget 

creating with high-level routine» 7-14 

creating with low-level routine * 8-30 

summary of attributes » A—7 
Common attributes 

description of > 8-2 

list of 8-4 


index 


Composite 


determining subclass of 2-133 
Compound string 
appending» 5-6 
bytes 
number of * 5-11 
comparing» 5-5 
copying * 5-8 
creating» 5-12 
definition of» 5—1 
displaying a message * 3-17 
text segment 
checking for* 5-10 
context of > 5-16 
parameters of* 5-14 
Compound string routines 
list of * 5—1 
CONFIGURE WIDGET routine» 2-66 
Convenience routines * 3-1 
definition of» 3-1 
list of * 3-1 
CONVERT CASE routine» 2-70 
Converter 
See Resource converter 
CONVERT routine + 2-68 
Coordinates 
translating widget» 2-219 
writing new widget + 2—66, 2-150 
COPY FROM CLIPBOARD routine « 6-15 
Copy menu item s+ 6-1 
Redo copy operations 6-1 
Undo copy operation» 6-1 
COPY TO CLIPBOARD routine + 6-18 
Core attributes 
list of > 8-4 
Create 
compound string» 5-18, 5-20 
LATIN1 strings 5-18 
CREATE APPLICATION CONTEXT routine * 2-71 
CREATE APPLICATION SHELL routine * 2-72 
CREATE FONT LIST routine» 5—4 
CREATE MANAGED WIDGET routine » 2-74 
CREATE POPUP SHELL routine» 2-76 
CREATE WIDGET routine» 2-78 
CREATE WINDOW routine + 2-80 
CS BYTE CMP routine» 5-5 
CS CAT routine» 5-6 
CS COPY routine» 5-8 
CS EMPTY routine» 5-10 
CS LEN routine» 5—11 
CS NCAT routine + 5-6 


Index 


CS NCOPY routine + 5-8 

CS STRING routine + 5-12 

Cut and paste routines 
See Clipboard 


See Next-paste item 
Cut and Paste routines 
list of * 6-2 
Cut menu item « 6-1 
Redo cut operations 6—1 
Undo cut operation» 6-1 


D 


Database 
errors 2-101 
error message * 2-102 
resource * 2-82 
DATABASE routine * 2-82 
Data ID/Private ID pair* 6-29 
Data type 
standard VAX«* 1-5 
Data type columns 1-5 
Default 
fatal error procedure * 2-95 
nonfatal error procedure » 2-229 
warning handler * 2-214, 2-215 
Default values 
of attached dialog box pop-up widget attributes « 
A-3 
of attached dialog box widget* B—1 
of attached dialog box widget attributes * A-1 
of caution box widget» B-5 
of caution box widget attributes « A-5 
of command window widget + B-7 
of command window widget attributes * A-7 
of dialog box pop-up widget» B-10 
of dialog box pop-up widget attributes > A-11 
of dialog box widget» B-3, B-9 
of dialog box widget attributes « A-9 
of file selection widget» B-12 
of file selection widget attributes » A-12 
of help widget» B-15 
of help widget attributes * A-15 
of label widget» B-18 
of label widget attributes * A-18 
of list box widget» B-20 
of list box widget attributes » A-20 
of main window widget» B—22 
of main window widget attributes > A-22 
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Default values (cont’d.) 


of menu bar widget» B-23 
of menu bar widget attributes » A-24 
of menu pop-up widget+ B-28 
of menu pop-up widget attributes » A-28 
of menu pull-down widget» B—29 
of menu pull-down widget attributes » A-30 
of menu widget * B-25 
of menu widget attributes *» A-26 
of message box widget» B-31 
of message box widget attributes » A-32 
of option menu widget» B-33 
of option menu widget attributes *» A-34 
of pull-down menu entry widget * B-35 
of pull-down menu entry widget attributes > A-37 
of push button widget» B-37 
of push button widget attributes * A-39 
of radio box widget» B-39 
of radio box widget attributes + A-41 
of scale widget» B-41 
of scale widget attributes * A-43 
of scroll bar widget* B-43 
of scroll bar widget attributes « A-45 
of scroll window widget + B—45 
of scroll window widget attributes > A-47 
of selection widget» B46 
of selection widget attributes « A-49 
of separator widget* B-49 
of separator widget attributes « A-51 
of simple text widget» B—50 
of simple text widget attributes « A-53 
of toggle button widget + B-52 
of toggle button widget attributes » A-55 
of window widget» B-54 
of window widget attributes > A~-57 
of work box widget» B-56 
of work box widget attributes *« A-59 
Deleting entry from list box widget * 7~33 
Deleting position from list box widget + 7-34 
Description section 
of routine format+ 1-7 
Descriptor 
getting a value* 3-12 
passing mechanisme 1-6 
Deselecting all items 
in a list box widget * 7—35 
Deselecting an item 
in a list box widget * 7-36 
Deselecting an item by position 
in a list box widget * 7-37 
DESTROY APPLICATION CONTEXT routine * 2-83 
DESTROY GC routine+ 2-84 


DESTROY WIDGET routine» 2-85 
DIALOG BOX CREATE routine + 8-35 
‘DIALOG BOX POPUP CREATE routine + 8-43 
Dialog box pop-up widget 
creating with low-level routine > 8-43 
summary of attributes» A-11, B—10 
DIALOG BOX routine» 7-16 
Dialog box widget 
creating with high-level routine > 7-16 
creating with low-level routine * 8-35 
summary of attributes > A-9, B-3, B-9 
DIRECT CONVERT routine + 2-87 
DISOWN SELECTION routine + 2—89 
DISPATCH EVENT routine» 2-91 
Display 
closing and removing * 2-65, 2-83 
gettings 3-3 
initializing * 2-93 
opening and initializing» 2-157 
DISPLAY CS MESSAGE routine» 3-17 
DISPLAY INITIALIZE routine » 2-93 
Display pointer 
returning * 2-92 
DISPLAY routine * 2-92 
DISPLAY VMS MESSAGE routine * 3-20 
Documentation formats 1-2 to 1-7 
DRM 
definition of + 4—1 
initializing applications * 4-22 
registering user-defined widget class * 4-25 
registering vector or names * 4—27 
DRM (XUI Resource Manager) + 4-1 
DRM FREE RESOURCE CONTEXT routine» 4-4 
DRM GET RESOURCE CONTEXT routine» 4-5 
DRM HGET INDEXED LITERAL routine + 4—7 
DRM RC BUFFER routine* 4-9 
DRM RC SET TYPE routine» 4-10 
DRM RC SIZE routine» 4-11 
DRM RC TYPE routine» 4-12 
DRM routines 
list of = 4—1 


E 


Editable text 

setting permission information » 7-98 
END COPY TO CLIPBOARD routine + 6-21 
Error condition 

fatal » 2-95, 2-203, 2-204 





index 


Error condition (cont’d.) 
nonfatal * 2-214, 2-215, 2-229, 2-230 
Error database 
obtaining» 2-101 
obtaining text» 2-102 
Error handler 
calling high-level * 2-96 
registering an error procedure * 2~203, 2-204 
Error message 
write in command windows 7-12 
ERROR MESSAGE routine * 2-96 
Error procedure 
fatal » 2-95 
nonfatal > 2-229 
ERROR routine» 2-95 
Event 
adding a new sources 2-33, 2-39 
dispatching + 2-91 
dispatching from main loop * 2-47 
looking for pending * 2—50 
mask 2-54 
merging * 2-30 
next in application + 2-48 
processing * 2-51 
waiting for* 2-48, 2-49 
Event handler 
adding* 2-28 
adding raw* 2-35 
registering *« 2-28, 2-35 
removing * 2-190 
removing raw* 2-194 
Event mask 
retrieving » 2-54 
Expose event 
adding to a region 2-30 
merging with Graphics Expose event+ 2-30 


F 


$FAO utility > 3-16 
Fatal errors 2—95, 2-203, 2-204 
FETCH INTERFACE MODULE routine + 4-13 
FETCH SET VALUES routine» 4—15 
FETCH WIDGET OVERRIDE routine» 4-19 
FETCH WIDGET routine* 4-17 
File 

registering anews 2-33, 2-39 
FILE SELECTION CREATE routine * 8-52 
FILE SELECTION DO SEARCH routine * 7-22 
FILE SELECTION routine * 7-19 
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index 


File selection widget 
creating with high-level routine » 7-19 
creating with low-level routine» 8-52 
summary of attributes » A-12, B—12 
Font list 
adding to» 5-3 
creating 5-4 
definition of > 5-1 
Format, documentations 1-2 to 1-7 
Format name 
getting list of data ID/private ID pairs » 6-29 
of next-paste item + 6-25 
Format section 
VAX* 1-3 
FREE routine» 2-98 
Function 
sending events to» 2-51 


G 


Gadget 
creating» 9-1 
definition » 9-1 
label » 9-3 
push button» 9-7 
separator» 9-11 
supported core attributes *> 9-2 
toggle buttons 9-14 
Gadget hierarchy * 9—1 
Gadget routines 
list of * 9-1 
GC 
See Graphics context 
Geometry management section 
of routine format+ 1—7 
Geometry request 
making * 2-139 
making resize request» 2-141 
GET APPLICATION RESOURCES routine » 2-99 
GET DISPLAY routine+ 3-3 
GET ERROR DATABASE routine » 2-101 
GET ERROR DATABASE TEXT routine » 2-102 
GET GC routine» 2-104 
GET NEXT SEGMENT routine» 5-14 
GET RESOURCE LIST routine + 2-106 
GET SCREEN routine» 3-4 
GET SELECTION TIMEOUT routine + 2-107 
GET SELECTION VALUE INCREMENTAL routine « 
2-111 
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GET SELECTION VALUE routine» 2-108 
GET SELECTION VALUES INCREMENTAL routine « 
2-118 
GET SELECTION VALUES routine» 2—115 
GET SUBRESOURCES routine * 2-122 
GET SUBVALUES routine + 2-124 
Getting permission state 
for a simple text widget» 7-92 
GET VALUES routine» 2-126 
GET WINDOW routine + 8-5 
Graphics context 
destroying * 2-84 
getting» 2-104 
Graphics Expose event 
adding to a region» 2-30 
merging with Expose event+ 2-30 


H 


HAS CALLBACKS routine + 2-128 
HELP CREATE routine» 8-58 
HELP routine» 7-24 
Help widget 
creating with high-level routine * 7—24 
creating with low-level routine «+ 8-58 
summary of attributes > A-15, B-15 
Hierarchy 
See also Gadget hierarchy 
See Widget class hierarchy 
closing* 4-3 
definition of > 4-3 
fetching indexed literal from * 4—7 
opening UID files in DRM* 4~—23 
High-level routines 
list of * 7-1 
High-level widget routines 
description of» 7—1 
Highlighting menu entries * 7-61 
Highlighting text 
in a simple text widget * 7-100 





Inheritance 
of widget attributes * 8~2 
INIT GET SEGMENT routine» 5-16 


Initialization 
of display * 2—93 
of XUI Toolkit» 2-129, 2-218 
INITIALIZE DRM routine * 4-22 
INITIALIZE routine » 2-129 
Input 
discontinuing * 2-193 
processing * 2-47, 2~138 
redirecting user* 2-31 
registering a new file» 2-33, 2-39 
Input queue 
looking for pending event» 2-50, 2-174 
returning value * 2-48, 2-49, 2-154, 2-173 
INQUIRE NEXT PASTE COUNT routine » 6-23 
INQUIRE NEXT PASTE FORMAT routine» 6-25 
INQUIRE NEXT PASTE LENGTH routine * 6-27 
INSTALL ACCELERATORS routine» 2-131 
INSTALL ALL ACCELERATORS routine » 2-132 
Instance 
See Widget instance 
Interface module 
definition of > 4-14 
fetching widgets of» 4-13 
intrinsic routines * 2-1 
list of * 2-1 
Intrinsics 
commonly used routines * 2—7 
definition * 2-7 
IS COMPOSITE routine » 2-133 
IS MANAGED routine» 2-134 
IS REALIZED routine» 2-135 
IS SENSITIVE routine 2-136 
IS SUBCLASS routine » 2—137 


K 


Keyboard input 

redirecting * 2—205 
Key-code-to-key-symbol translator 

invoking * 2—221 

registering a key translator» 2—206 
Key symbol 

equivalents for* 2-70 

translating » 2-221 


L 


LABEL CREATE routine» 8~70 








index 


Label gadget 
creating» 9-3 
LABEL GADGET CREATE routine» 9~3 
LABEL routine» 7-27 
Label widget 
creating with high-level routine * 7~27 
creating with low-level routine * 8-70 
summary of attributes > A-18, B—18 
LATIN1 STRING routine» 5-18 
LIST BOX ADD ITEM routine « 7-32 
LIST BOX CREATE routine « 8-75 
LIST BOX DELETE ITEM routine» 7-33 
LIST BOX DELETE POS routine» 7-34 
LIST BOX DESELECT ALL ITEMS routine» 7-35 
LIST BOX DESELECT ITEM routine» 7-36 
LIST BOX DESELECT POS routine * 7-37 
LIST BOX ITEM EXISTS routine * 7-38 
LIST BOX routine + 7-29 
LIST BOX SELECT ITEM routine + 7-39 
LIST BOX SELECT POS routine» 7-40 
LIST BOX SET HORIZ POS routine» 7-41 
LIST BOX SET ITEM routine» 7—42 
LIST BOX SET POS routine» 7-43 
List box widget 
creating with high-level routine * 7-29 
creating with low-level routine * 8—75 
summary of attributes * A—-20, B—20 
LIST PENDING ITEMS routine» 6-29 
Low-level widget routines 
description of * 8~1 
list of * 8—1 


Main loop 
application * 2-47 
MAIN LOOP routine» 2-138 
MAIN WINDOW CREATE routine* 8-83 
MAIN WINDOW routine» 7-44 
MAIN WINDOW SET AREAS routine * 7—46 
Main window widget 
creating with high-level routine * 7-44 
creating with low-level routine * 8-83 
summary of attributes * A-22, B~22 
MAKE GEOMETRY REQUEST routine» 2-139 
MAKE RESIZE REQUEST routine + 2-141 
MALLOC routine * 2-143 
MANAGE CHILDREN routine» 2-145 
MANAGE CHILD routine» 2-144 
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Index 


Managed widget 

creating 2-74 
MAP WIDGET routine» 2—147 
Mechanism column 

‘in VAX format+* 1-6 
Memory 


See Storage 
freeing for argument names* 3-11 
Menu 
See also MENU 
See also MENU BAR 
See also MENU BAR CREATE routine 
See also MENU CREATE routine 
See also MENU POPUP CREATE routine 
See also MENU PULLDOWN CREATE routine 
See also OPTION MENU 
See also OPTION MENU CREATE routine 
See also PULL DOWN MENU ENTRY 
See also PULL DOWN MENU ENTRY CREATE 
. routine 
See also RADIO BOX 
See also RADIO BOX CREATE routine 
creating a menus 7-48 
Menu bar 
adding to main window + 7-46 
MENU BAR CREATE routine» 8—89 
MENU BAR routine» 7-51 
Menu bar widget 
creating with high-level routine * 7—51 
creating with low-level routine * 8-89 
summary of attributes » A-24, B-23 
MENU CREATE routine» 8-92 
MENU POPUP CREATE routine + 8-102 
Menu pop-up widget 
creating with low-level routine * 8-102 
summary of attributes » A-28, B-28 
MENU POSITION routine * 7-53 
MENU PULLDOWN CREATE routine * 8-104 
Menu pull-down widget 
creating with low-level routine» 8—104 
summary of attributes » A-30, B—29 
MENU routine * 7-48 
Menu widget 
creating with high-level routine > 7—48 
creating with low-level routine » 8-92 
summary of attributes *« A-26, B—25 
MERGE ARG LISTS routine «+ 2—148 
Message 
debugging error» 2-63 
errors 2-96 
warning * 2-230 
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Message box 
displaying compound string messages * 3-17 
displaying VMS messages * 3-20 
MESSAGE BOX CREATE routine * 8-106 
MESSAGE BOX routine * 7-54 
Message box widget 
creating with high-level routine * 7-54 
creating with low-level routine * 8-106 
summary of attributes > A-32, B-31 
Message routines 
definition of > 3-16 
list of © 3-1 
MIT C 
formats 1-6 
Modal cascade 
dispatching user events * 2-31 
removing widget from* 2-192 
Modify access * 1-5 
MOVE WIDGET routine «+ 2—150 


N 


NAME TO WIDGET routine * 2-151 
New logical application 

creating * 2-45 
NEW STRING routine * 2-153 
NEXT EVENT routine» 2~—154 
Next-paste item 

definition of * 6-6 

format name for* 6-25 

length of * 6-27 

number of * 6-23 
NUMBER CHILDREN routine» 3-6 
NUMBER routine» 2—155 


O 


OFFSET routine» 2~—156 
OPEN DISPLAY routine «+ 2-157 
OPEN HIERARCHY routine» 4-23 
OPTION MENU CREATE routine» 8-110 
OPTION MENU routine * 7-57 
Option menu widget 
creating with high-level routine * 7-57 
creating with low-level routine » 8-110 
summary of attributes « A-34, B-33 
Organization 
of routines* 1-1 








Output buffer 

flushing * 2-48 
OVERRIDE TRANSLATIONS routine + 2-159 
Overview sections 1-3 
OWN SELECTION INCREMENTAL routine + 2-164 
OWN SELECTION routine» 2-160 


p 


PARENT routine * 2-170 
PARSE ACCELERATOR TABLE routine» 2-171 
PARSE TRANSLATION TABLE routine * 2-172 
Part offset 
records 3-7 
resolving for upward compatibility * 3-7 
Passing mechanism 
by descriptor 1-6 
by reference» 1-6 
by value* 1-6 
Paste menu item* 6-1 
Redo paste operation + 6-1 
Undo paste operation + 6—1 
PEEK EVENT routine * 2-173 
PENDING routine» 2-174 
Pointer 
See Passing mechanism by reference 
Pointer cursor 
translating to widget instance * 2-235 
POPDOWN routine * 2-175 
POPUP routine + 2-176 
Pop-up shell 
bringing downs 2-175 
bringing up * 2-176 
creating» 2-76 
mapping * 2-176 
unmapping * 2—175 
Positioning 
menus 7-53 
Positioning widget 
See Coordinates 
Primitive widget * 2-140, 2-181 
Private ID/Data ID pair 
See Data !ID/Private ID pair 
Procedures 
See also Work procedure 
accept input focus « 2—55 
XtCancelConvertSelectionProc +» 2-113, 2-120 
XtCancelSelectionCallbackProc » 2-168 
XtConvertSelectionIncrProc * 2-165 
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Procedures (cont’d.) 


XtConvertSelectionProc* 2-161 
XtLoseSelectionIncrProc * 2—167 
XtLoseSelectionProc * 2—162 
XtSelectionCallbackProc * 2-109, 2-112, 2-116 
XtSelectionDonelnerProc * 2-167 
XtSelectionDoneProc * 2—162 
XtSelectionIncrCallbackProc* 2-119 

PROCESS EVENT routine + 2-178 

PULL DOWN MENU ENTRY CREATE routine « 

8-113 

PULL DOWN MENU ENTRY HILITE routine * 7-61 

PULL DOWN MENU ENTRY routine» 7-59 

Pull down menu entry widget 
creating with high-level routine » 7-59 
creating with low-level routine * 8-113 
summary of attributes » A-37, B-35 

PUSH BUTTON CREATE routine * 8—117 

Push button gadget 
creating * 9-7 

PUSH BUTTON GADGET CREATE routine» 9-7 

PUSH BUTTON routine * 7-62 

Push button widget 
creating with high-level routine » 7-62 
creating with low-level routine > 8-117 
summary of attributes > A-39, B—37 


Q 


QUERY GEOMETRY routine * 2-179 
Queue 
See Input queue 


R 


RADIO BOX CREATE routine * 8-123 
RADIO BOX routine * 7-64 
Radio box widget 
creating with high-level routine « 7-64 
creating with low-level routine * 8-123 
summary of attributes > A-41, B-39 
Read access* 1-5 
Realization 
See Widget realization 
REALIZE WIDGET routine * 2-181 
REALLOC routine * 2-183 
RECOPY TO CLIPBOARD routine + 6-31 
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Reference 

passing mechanisms 1-6 
REGISTER CASE CONVERTER routine» 2-184 
REGISTER CLASS routine» 4-25 
REGISTER DRM NAMES routine» 4-27 
REMOVE ALL CALLBACKS routine» 2-186 
REMOVE CALLBACK routine » 2-187 
REMOVE CALLBACKS routine + 2-189 
REMOVE EVENT HANDLER routine» 2-190 
REMOVE GRAB routine * 2—192 
REMOVE INPUT routine» 2—193 
REMOVE RAW EVENT HANDLER routine» 2-194 
REMOVE TIME OUT routine» 2-196 
REMOVE WORK PROC routine > 2—197 
Replace command string * 7-13 
RESIZE WIDGET routine » 2-198 
RESIZE WINDOW routine + 2—200 
Resizing section 

of routine format* 1—7 
Resizing widget» 2-66, 2-141, 2-150. 
RESOLVE PART OFFSETS routine + 3-7 
Resource context 

freeing * 4—4 

getting: 4-5 

modifying type in» 4-10 

returning pointer tos 4~9 

value 

returning size of > 4—11 
returning type of» 4-12 

Resource conversions 

invoking * 2-68, 2-87 
Resource converter 

registering * 2-26 

string conversions * 2-216 
Resource database * 2-82 
Resource list structure 

obtaining » 2—106 
Resources 

retrieving * 2-124, 2-126 

retrieving application * 2-99 

retrieving for nonwidget subparts * 2—122 

setting subvalues * 2-210 

setting values * 2-212 
Returns section 

of routine format+ 1-6 
Root coordinates * 2-219 
Routine 

name sections 1—2 

template» 1-2 
Routines 

ADD ACTIONS + 2-23 

ADD CALLBACKe 2-24 
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Routines (cont’d.) 


ADD CALLBACKS + 2-25 

ADD CONVERTER ® 2-26 

ADD EVENT HANDLER « 2-28 

ADD EXPOSURE TO REGION + 2-30 

ADD FONT LIST « 5-3 

ADD GRAB» 2-31 

ADD INPUT + 2-33 

ADD RAW EVENT HANDLER» 2-35 

ADD TIMEOUT + 2-37 

ADD WORK PROC « 2-38 

APPLICATION ADD INPUT + 2-39 

APPLICATION ADD TIME OUT + 2-41 

APPLICATION ADD WORK PROC « 2-43 

APPLICATION CREATE SHELL* 2-45 

APPLICATION MAIN LOOP + 2-47 

APPLICATION NEXT EVENT + 2-48 

APPLICATION PEEK EVENT + 2-49 

APPLICATION PENDING «+ 2-50 

APPLICATION PROCESS EVENT + 2-51 

ATTACH DIALOG BOX CREATE « 8-11 

ATTACHED DIALOG BOX« 7-5 

ATTACHED DIALOG BOX POPUP CREATE « 
8-21 

AUGMENT TRANSLATIONS « 2-53 

BEGIN COPY TO CLIPBOARD > 6-4 

BUILD EVENT MASK» 2-54 

CALL ACCEPT FOCUS + 2-55 

CALLBACK EXCLUSIVE + 2-57 

CALLBACK NONE « 2-58 

CALLBACK NONEXCLUSIVE + 2-59 

CALLBACK POPDOWN = 2-60 

CALL CALLBACKS « 2-56 

CALLOC + 2-62 

CANCEL COPY FORMAT « 6-7 

CANCEL COPY TO CLIPBOARD « 6-9 

CAUTION BOX* 7-8 . 

CAUTION BOX CREATE * 8-24 

CHECK SUBCLASS « 2-63 

CHILDREN + 3-2 

CLASS + 2-64 

CLIPBOARD LOCK « 6-11 

CLIPBOARD UNLOCK» 6-13 

CLOSE DISPLAY + 2-65 

CLOSE HIERARCHY + 4-3 

COMMAND APPEND « 7-11 

COMMAND ERROR MESSAGE * 7-12 

COMMAND SET» 7-13 

COMMAND WINDOW « 7-14 

COMMAND WINDOW CREATE « 8-30 

CONFIGURE WIDGET + 2-66 

CONVERT « 2-68 


Routines (cont’d.) 


CONVERT CASE * 2-70 

COPY FROM CLIPBOARD « 6-15 
COPY TO CLIPBOARD « 6-18 
CREATE APPLICATION CONTEXT + 2-71 
CREATE APPLICATION SHELL + 2-72 
CREATE FONT LIST + 5-4 

CREATE MANAGED WIDGET «+ 2-74 
CREATE POPUP SHELL» 2~76 
CREATE WIDGET + 2-78 

CREATE WINDOW « 2-80 

CS BYTE CMP « 5-5 

CS CAT + 5-6 

CS COPY « 5-8 

CS EMPTY « 5-10 

CS LEN« 5-11 

CS NCAT + 5-6 

CS NCOPY + 5-8 

CS STRING 5-12 

DATABASE « 2-82 

DESTROY APPLICATION CONTEXT « 2-83 
DESTROY GC + 2-84 

DESTROY WIDGET + 2-85 

DIALOG BOX* 7-16 

DIALOG BOX CREATE « 8-35 
DIALOG BOX POPUP CREATE « 8-43 
DIRECT CONVERT + 2-87 

DISOWN SELECTION «+ 2-89 
DISPATCH EVENT + 2-91 

DISPLAY * 2-92 

DISPLAY CS MESSAGE + 3-17 
DISPLAY INITIALIZE + 2-93 

DISPLAY VMS MESSAGE + 3-20 
DRM FREE RESOURCE CONTEXT 4-4 
DRM GET RESOURCE CONTEXT» 4-5 
DRM HGET INDEXED LITERAL®* 4-7 
DRM RC BUFFER» 4-9 

DRM RC SET TYPE + 4-10 

DRM RC SIZE* 4—11 

DRM RC TYPE 4-12 

END COPY TO CLIPBOARD « 6-21 
ERROR « 2-95 

ERROR MESSAGE « 2-96 

FETCH INTERFACE MODULE + 4-13 
FETCH SET VALUES« 4-15 

FETCH WIDGET + 4-17 

FETCH WIDGET OVERRIDE * 4-19 
FILE SELECTION + 7-19 

FILE SELECTION CREATE * 8-52 
FILE SELECTION DO SEARCH « 7-22 
FREE* 2-98 

GET APPLICATION RESOURCES « 2-99 
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Routines (cont’d.) 


GET DISPLAY + 3-3 

GET ERROR DATABASE « 2-101 

GET ERROR DATABASE TEXT» 2-102 

GET GC 2-104 

GET NEXT SEGMENT « 5-14 

GET RESOURCE LIST + 2-106 

GET SCREEN + 3-4 

GET SELECTION TIMEOUT + 2-107 

GET SELECTION VALUE + 2-108 

GET SELECTION VALUE INCREMENTAL « 2-111 

GET SELECTION VALUES « 2-115 

GET SELECTION VALUES INCREMENTAL « 
2-118 

GET SUBRESOURCES « 2-122 

GET SUBVALUES « 2-124 

GET VALUES « 2-126 

GET WINDOW « 3-5 

HAS CALLBACKS + 2-128 

HELP + 7-24 

HELP CREATE* 8-58 

INIT GET SEGMENT «+ 5-16 

INITIALIZE « 2-129 

INITIALIZE DRM* 4-22 

INQUIRE NEXT PASTE COUNT * 6-23 

INQUIRE NEXT PASTE FORMAT « 6-25 

INQUIRE NEXT PASTE LENGTH « 6-27 

INSTALL ACCELERATORS « 2-131 

INSTALL ALL ACCELERATORS « 2-132 

IS COMPOSITE « 2-133 

IS MANAGED « 2-134 

IS REALIZED * 2-135 

IS SENSITIVE * 2-136 

IS SUBCLASS * 2-137 

LABEL* 7-27 

LABEL CREATE «+ 8-70 

LABEL GADGET CREATE®* 9-3 

LATIN1 STRING* 5-18 

LIST BOX+ 7-29 

LIST BOX ADD ITEM* 7-32 


_ LIST BOX CREATE + 8-75 


LIST BOX DELETE ITEM 7-33 
LIST BOX DELETE POS + 7-34 
LIST BOX DESELECT ALL ITEMS + 7-35 
LIST BOX DESELECT ITEM» 7-36 
LIST BOX DESELECT POS* 7-37 
LIST BOX ITEM EXISTS « 7-38 
LIST BOX SELECT ITEM* 7-39 
LIST BOX SELECT POS + 7-40 
LIST BOX SET HORIZ POS « 7-41 
LIST BOX SET ITEM* 7-42 

LIST BOX SET POS « 7-43 
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Routines (cont’d.) 


LIST PENDING ITEMS «+ 6-29 

MAIN LOOP + 2-138 

MAIN WINDOW + 7-44 

MAIN WINDOW CREATE + 8-83 

MAIN WINDOW SET AREAS + 7-46 
MAKE GEOMETRY REQUEST 2-139 
MAKE RESIZE REQUEST + 2-141 
MALLOC + 2-143 

MANAGE CHILD + 2-144 

MANAGE CHILDREN « 2-145 

MAP WIDGET « 2-147 

MENU « 7-48 

MENU BAR « 7-51 

MENU BAR CREATE « 8-89 

MENU CREATE * 8-92 

MENU POPUP CREATE * 8-102 
MENU POSITION « 7-53 

MENU PULLDOWN CREATE « 8-104 
MERGE ARG LISTS « 2-148 
MESSAGE BOX« 7-54 

MESSAGE BOX CREATE « 8-106 
MOVE WIDGET: 2-150 

NAME TO WIDGET + 2-151 

NEW STRING*s 2-153 

NEXT EVENT « 2-154 

NUMBER « 2-155 

NUMBER CHILDREN « 3-6 

OFFSET + 2-156 

OPEN DISPLAY + 2-157 

OPEN HIERARCHY « 4-23 

OPTION MENU 7-57 

OPTION MENU CREATE + 8-110 
OVERRIDE TRANSLATIONS + 2-159 
OWN SELECTION « 2-160 

OWN SELECTION INCREMENTAL « 2-164 
PARENT * 2-170 

PARSE ACCELERATOR TABLE « 2-171 
PARSE TRANSLATION TABLE « 2-172 
PEEK EVENT 2-173 
PENDING « 2-174 

POPDOWN « 2-175 

POPUP + 2-176 

PROCESS EVENT « 2-178 

PULL DOWN MENU ENTRY « 7-59 
PULL DOWN MENU ENTRY CREATE « 8-113 
PULL DOWN MENU ENTRY HILITE + 7-61 
PUSH BUTTON: 7-62 

PUSH BUTTON CREATE + 8-117 
PUSH BUTTON GADGET CREATE * 9-7 
QUERY GEOMETRY « 2-179 

RADIO BOX* 7-64 
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Routines (cont’d.) 


RADIO BOX CREATE+ 8-123 
REALIZE WIDGET+ 2-181 

REALLOC + 2-183 

RECOPY TO CLIPBOARD + 6-31 
REGISTER CASE CONVERTER® 2-184 
REGISTER CLASS + 4-25 
REGISTER DRM NAMES» 4-27 
REMOVE ALL CALLBACKS + 2-186 
REMOVE CALLBACK + 2-187 

REMOVE CALLBACKS + 2-189 
REMOVE EVENT HANDLER + 2-190 
REMOVE GRAB 2-192 

REMOVE INPUT 2-193 

REMOVE RAW EVENT HANDLER + 2-194 
REMOVE TIME OUT 2-196 

REMOVE WORK PROC + 2-197 
RESIZE WIDGET+ 2-198 

RESIZE WINDOW- 2-200 

RESOLVE PART OFFSETS + 3-7 
SCALE + 7-66 

SCALE CREATE 8-127 

SCALE GET SLIDER 7-70 

SCALE SET SLIDER+ 7-71 

SCREEN > 2-201 

SCROLL BAR+ 7-72. 

SCROLL BAR CREATE 8-133 
SCROLL BAR GET SLIDER + 7-76 
SCROLL BAR SET SLIDER- 7-78 
SCROLL WINDOW 7-80 

SCROLL WINDOW CREATE 8-141 
SCROLL WINDOW SET AREAS + 7-82 
SELECTION + 7-84 

SELECTION CREATE + 8-145 
SEPARATOR + 7-87 

SEPARATOR CREATE 8-151 
SEPARATOR GADGET CREATE* 9-11 
SET ARG> 2-202 

SET ERROR HANDLER» 2-203 

SET ERROR MESSAGE HANDLER « 2-204 
SET KEYBOARD FOCUS + 2-205 

SET KEY TRANSLATOR + 2-206 

SET MAPPED WHEN MANAGED « 2-207 
SET SELECTION TIMEOUT + 2-208 
SET SENSITIVE+ 2-209 

SET SUBVALUES +» 2-210 

SET VALUES + 2-212 

SET WARNING HANDLER * 2-214 

SET WARNING MESSAGE HANDLER 2-215 
S TEXT + 7-89 

S TEXT CLEAR SELECTION + 7-91 

S TEXT CREATE- 8-154 


Routines (cont’d.) 
S TEXT GET EDITABLE + 7-92 
S TEXT GET MAX LENGTH « 7-93 
S TEXT GET SELECTION « 7-94 
S TEXT GET STRING «+ 7-95 
S TEXT REPLACE « 7-96 
S TEXT SET EDITABLE + 7-98 
S TEXT SET MAX LENGTH» 7-99 
S TEXT SET SELECTION « 7-100 
S TEXT SET STRING» 7-102 
STRING « 5-20 
STRING CONVERSION WARNING « 2-216 
SUPERCLASS + 2-217 
TOGGLE BUTTON « 7-103 
TOGGLE BUTTON CREATE 8-162 
TOGGLE BUTTON GADGET CREATE * 9-14 
TOGGLE BUTTON GET STATE « 7-105 
TOGGLE BUTTON SET STATE * 7-106 
TOOLKIT INITIALIZE + 2-218 
TRANSLATE COORDS + 2-219 
TRANSLATE KEYCODE « 2-221 
UNDO COPY TO CLIPBOARD « 6-33 
UNINSTALL TRANSLATIONS © 2-223 
UNMANAGE CHILD+ 2-224 
UNMANAGE CHILDREN « 2-225 
UNREALIZE WIDGET + 2-228 
VMS CLEAR STRING» 3-10 
VMS FREE ARGNAMES « 3-11 
VMS GET DESC VALUE + 3-12 
VMS SET ARG» 3-13 
VMS SET CALLBACK ARG « 3-14 
VMS SET DESC ARG» 3-15 
WARNING + 2-229 
WARNING MESSAGE « 2-230 
WIDGET TO APPLICATION CONTEXT * 2-232 
WINDOW « 2-233, 7-107 
WINDOW CREATE « 8-168 
WINDOW TO WIDGET + 2-235 
WORK BOX « 7-109 
WORK BOX CREATE « 8-172 
Routines, organizations 1—1 
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SCALE CREATE routine» 8-127 
SCALE GET SLIDER routine» 7-70 
SCALE routine» 7-66 
SCALE SET SLIDER routine * 7-71 
Scale widget 

creating with high-level routine * 7-66 
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Scale widget (cont’d.) 

creating with low-level routine * 8-127 

summary of attributes > A-43, B—41 
Screen 

getting: 3-4 
SCREEN routine * 2-201 
Scroll bar 

adding to main windows 7-46 

creating with low-level routine » 8-133 
SCROLL BAR CREATE routine * 8-133 
SCROLL BAR GET SLIDER routine» 7-76 
SCROLL BAR routine * 7-72 
SCROLL BAR SET SLIDER routine + 7~78 
Scroll bar slider 

setting the horizontal position in a list box * 7-41 
Scroll bar widget 

creating with high-level routine * 7-72 

summary of attributes > A-45, B43 
SCROLL WINDOW CREATE routine + 8-141 
SCROLL WINDOW routine» 7-80 
SCROLL WINDOW SET AREAS routines 7-82 
Scroll window widget 

creating with high-level routine * 7-80 

creating with low-level routine > 8-141 

summary of attributes > A-47, B—45 
Selecting an item 

in a list box widget * 7-39 
Selecting an item by position 

in a list box widget» 7-40 
Selection 

defining the owner* 2-160, 2-164 

disowning * 2-89 

timeout value * 2—107 

value * 2-108, 2-111, 2-115, 2-118 
SELECTION CREATE routine * 8-145 
SELECTION routine «+ 7-84 
Selection timeout 

setting * 2-208 
Selection widget 

creating with high-level routine * 7-84 

creating with low-level routine > 8-145 

summary of attributes > A-~49, B—46 
Sensitivity state 

determining for widget» 2-136 

setting for widget» 2-209 
SEPARATOR CREATE routine» 8-151 
Separator gadget 

creating * 9-11 
SEPARATOR GADGET CREATE routine» 9~11 
SEPARATOR routine + 7-87 
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Separator widget 


creating with high-level routine * 7-87 
creating with low-level routine » 8-151 
summary of attributes > A-51, B—49 
SET ARG routine» 2-202 
SET ERROR HANDLER routine» 2-203 
SET ERROR MESSAGE HANDLER routine» 2~—204 
SET KEYBOARD FOCUS routine + 2-205 
SET KEY TRANSLATOR routine * 2-206 
SET MAPPED WHEN MANAGED routine » 2-207 
SET SELECTION TIMEOUT routine * 2-208 
SET SENSITIVE routine » 2-209 
SET SUBVALUES routine * 2-210 
Setting an item first 
in a list box widget» 7—42 
Setting an item first by position 
in a list box widget* 7-43 
SET VALUES routine + 2-212 
SET WARNING HANDLER routine» 2-214 
SET WARNING MESSAGE HANDLER routine « 
2-215 
Shell widget» 2-10 
attributes > 2-12 to 2—21 
creating on another display « 2-45, 2-72 
creating pop-up * 2-76 
hierarchy * 2-10 
MIT C attributes > 2-13 
Simple text widget 
creating with high-level routine * 7-89 
creating with low-level routine » 8-154 
getting global selection » 7-94 
getting maximum length» 7-93 
replacing text» 7—96 
setting maximum length» 7-99 
setting permission information « 7—98 
setting selection» 7-100 
summary of attributes » A-53, B—50 
Slider position 
get current value of» 7-70 
set/change current value of * 7-71 
Slider size/position 
get» 7-76 
set/change* 7-78 
S TEXT CLEAR SELECTION routine» 7-91 
S TEXT CREATE routine» 8-154 
S TEXT GET EDITABLE routine * 7-92 
S TEXT GET MAX LENGTH routine + 7-93 
S TEXT GET SELECTION routine « 7—94 
S TEXT GET STRING routine» 7-95 
S TEXT REPLACE routine» 7-96 
S TEXT routine» 7-89 
S TEXT SET EDITABLE routine» 7-98 
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S TEXT SET MAX LENGTH routine * 7-99 
S TEXT SET SELECTION routine » 7-100 
S TEXT SET STRING routine » 7-102 

S text widget 


See also simple text widget 


See simple text widget 
Storage 

allocating 2-143 

freeing * 2~98 

reallocating * 2-183 
String 

See also Compound string 

clearing * 3-10 

copying * 2-153 
STRING CONVERSION WARNING routine 2—216 
STRING routine * 5-20 
Subclass 

determining for widget» 2-137 
Superclass 

determining for widget» 2-217 
SUPERCLASS routine * 2—217 
Syntax * 1-3 
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Text segment 


See Compound string 
Text string 
displaying new* 7-102 
getting currently displayed +» 7-95 
Text widget 
See the Simple text widget 
get permission information * 7-92 
Timeout 
clearing value * 2—196 
creating * 2-37 
creating for application * 2-41 
returning value * 2—107 
setting selection * 2-208 
TOGGLE BUTTON CREATE routine» 8-162 
Toggle button gadget 
creating» 9-14 
TOGGLE BUTTON GADGET CREATE routine « 
9-14 
TOGGLE BUTTON GET STATE routine » 7—105 
TOGGLE BUTTON routine» 7-103 
TOGGLE BUTTON SET STATE routine » 7-106 
Toggle button widget 
creating with high-level routine * 7-103 





Toggle button widget (cont’d.) 


creating with low-level routine * 8-162 

getting state of» 7-105 

setting state of * 7-106 

summary of attributes » A-55, B-52 
Toolkit 

See XUI Toolkit 
TOOLKIT INITIALIZE routine » 2-218 
TRANSLATE COORDS routine + 2-219 
TRANSLATE KEYCODE routine» 2-221 
Translation manager 

registering action table with» 2-23 
Translations 

merging news 2-53 

overwriting * 2-159 
Translation table 

merging new translations » 2-53 

parsing» 2-172 

removing * 2-223 
Types 1-5 
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UNDO COPY TO CLIPBOARD routine + 6-33 
UNINSTALL TRANSLATIONS routine * 2-223 
UNMANAGE CHILDREN routine + 2-225 
UNMANAGE CHILD routine - 2-224 
UNMAP WIDGET « 2-227 
UNREALIZE WIDGET routine» 2-228 
Usage 

table of VMS usage+ 1-4 
Usage columns 1-4 
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Value 

passing mechanism* 1-6 
Verifying an item’s existence 

in a list box widget» 7-38 
VMS CLEAR STRING routine * 3-10 
VMS FREE ARGNAMES routine + 3—11 
VMS GET DESC VALUE routine+ 3-12 
VMS SET ARG routines 3-13 
VMS SET CALLBACK ARG routine» 3-14 
VMS SET DESC ARG routine» 3-15 
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Warning 
string conversion» 2-216 
Warning handler 
calling default» 2-230 
registering a procedure * 2-214, 2-215 
WARNING MESSAGE routine + 2—230 
WARNING routine » 2-229 
Widget 
appending to modal cascade 2-31 
bringing down 2-60 
children of * 3-2 
creating * 2-76, 2~78 
creating application * 2-72 
creating application shell+ 2-45 
creating managed + 2-74 
destroying 2-85 
destroying windows * 2—228 
determining class structure» 2-64 
determining managed state of child» 2-134 
determining sensitivity state» 2-136 
determining subclass * 2~63, 2-133, 2-137 
determining superclass * 2-217 
fetching indexed * 4—17 
handling input» 2-9, 2-47, 2-138 
initializing and managing 2-8 
making resize request» 2-141 
manipulation at run time « 2-7 
manipulation routines for» 2-8 
mapping * 2-147 
moving * 2-150 
moving and resizing * 2-66 
number of children * 3-6 
overriding fetch arguments * 4-19 
overwriting translations * 2-159 
pop-up * 2—176 
primitive * 2-140, 2-181 
removing from modal cascade * 2-192 
resizing * 2-198 
retrieving event masks 2-54 
returning parent» 2-170 
sending events to* 2-51 
set sensitivity state * 2-209 
shell* 2-10 
translating coordinates * 2-219 
translating name + 2-151 
unmapping * 2-227 
unrealize * 2—228 
upward-compatible * 3-7 


Index 


Widget (cont’d.) 
user-defined class of * 4—25 
writing new coordinates * 2-66, 2-150 
Widget classes « 8-2 
Widget class hierarchy * 8-2 
figure of * 8~2 
Widget coordinates 
translating » 2-219 
writing new widget * 2-66, 2-150 
Widget creation * 2-45, 2-72, 2-74, 2-76, 2-78 
Widget geometry 
determining preferred geometry * 2-179 
making geometry request * 2-139 
Widget instance 
creating * 2~78 
definition » 2—79 
destroying» 2-85 
retrieving resource datae 2—124, 2-126 
translating widget name to» 2-151 
translating window to* 2—235 
Widget realization 
determining for widget» 2-135 
performing * 2-9, 2-181 
unrealizing widget * 2-228 
Widget subclass 
determining * 2-137 
Widget superclass 
determining * 2—217 
WIDGET TO APPLICATION CONTEXT routine « 
2-232 
Window 
See also COMMAND WINDOW CREATE routine 
See also MAIN WINDOW CREATE routine 
See also SCROLL WINDOW CREATE routine 
See also WINDOW CREATE routine 
See COMMAND WINDOW routine 
See MAIN WINDOW routine 
See WINDOW routine 
creating 2-80, 7-107 
creating a commands 7-14 
creating a mains 7-44 
creating a main windows 8-83 
creating a scroll windows 8—141 
creating a windows 8-168 
destroying * 2-228 
getting 3-5 
mapping and unmapping » 2-207 
resizing * 2-200 
return of a specified widget * 2-233 
translating to widget instance * 2-235 
WINDOW CREATE routine» 8-168 
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Window region, set up * 7-82 
WINDOW routine » 2-233, 7-107 
WINDOW TO WIDGET routine * 2-235 
Window widget 
creating with high-level routine * 7—107 
creating with low-level routine > 8-168 
summary of attributes » A-57, B~54 
Window widget, set up mains 7-46 
WORK BOX CREATE routine» 8-172 
WORK BOX routine « 7-109 
Work box widget 
creating with high-level routine » 7-109 
creating with low-level routine * 8-172 
summary of attributes > A-59, B-56 
Work procedure 
adding for application» 2-43 
registering * 2-38 
removing * 2-197 
Work window 
adding to main window * 7—46 
Write access* 1-5 


X 


XtCancelConvertSelectionProc procedure * 2-113, 
2-120 
XtCancelSelectionCallbackProc procedure + 2-168 
XtConvertSelectionIncrProc procedure » 2-165 
XtConvertSelectionProc procedure * 2-161 
XtLoseSelectionIncrProc procedure » 2-167 
XtLoseSelectionProc procedure * 2-162 
XtSelectionCallbackProc procedure + 2-109, 2-112, 
2-116 
XtSelectionDonelncrProc procedure * 2-167: 
XtSelectionDoneProc procedure * 2-162 
XtSelectionIncrCallbackProc procedure * 2-119 
XUI resource manager 


See DRM 

XUI Toolkit 
initializing * 2-129 
initializing internals * 2-218 
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Technical Support 


If you need help deciding which documentation best meets your needs, call 800-343-4040 before placing 


your electronic, telephone, or direct mail order. 


Electronic Orders 


To place an order at the Electronic Store, dial 800-DEC-DEMO (800-332-3366) using a 1200- or 2400-baud 
modem. If you need assistance using the Electronic Store, call 800-DIGITAL (800-344-4825). 


Telephone and Direct Mail Orders 


Your Location 
Continental USA, 
Alaska, or Hawaii 


Puerto Rico 


Canada 


International 


Internal 


Call 
800-DIGITAL 


809-754-7575 
800-267-6215 


Contact 


Digital Equipment Corporation 
P.O. Box CS2008 
Nashua, New Hampshire 03061 


Local DIGITAL subsidiary 


Digital Equipment of Canada 

Attn: DECdirect Operations KAO2/2 
P.O. Box 13000 

100 Herzberg Road 

Kanata, Ontario, Canada K2K 2A6 


Local DIGITAL subsidiary or 
approved distributor 


SDC Order Processing - WMO/E15 
or 

Software Distribution Center 
Digital Equipment Corporation 
Westminster, Massachusetts 01473 


1¥For internal orders, you must submit an Internal Software Order Form (EN-01740-07). 
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Please use this postage-paid form to comment on this manual. If you require a written reply to a software 
problem and are eligible to receive one under Software Performance Report (SPR) service, submit your 
comments on an SPR form. 


Thank you for your assistance. 


I rate this manual’s: Excellent Good Fair Poor 


Accuracy (software works as manual says) 
Completeness (enough information) 
Clarity (easy to understand) 

Organization (structure of subject matter) 
Figures (useful) 

Examples (useful) 

Index (ability to find topic) 

Page layout (easy to find information) 
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I would like to see more/less 


What I like best about this manual is 


What I like least about this manual is 


I found the following errors in this manual: 
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I am using Version of the software this manual describes. 
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